Copier des lignes sur une feuille Excel v3.0

Copier les données et les formats à partir de lignes entières spécifiques d’une feuille de calcul.

Conditions préalables

#	Exigence
1	Un jeton JWT valide. Voir le guide d’authentification.
2	Le classeur (`{name}`) doit déjà exister dans le dossier / stockage sélectionné.
3	La feuille cible (`{sheetName}`) doit être présente dans le classeur.
4	(Facultatif) Connaître le dossier et le storageName si le fichier n’est pas situé à l’emplacement par défaut.

Point de terminaison

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/copy

Tous les paramètres de chemin sont sensibles à la casse.

Paramètres de chemin

Paramètre	Type	Obligatoire	Description
`name`	string	✅	Nom du fichier de classeur (par exemple, `test.xlsx`).
`sheetName`	string	✅	Nom de la feuille de calcul (par exemple, `Sheet1`).

Paramètres de requête

Paramètre	Type	Obligatoire	Description
`sourceRowIndex`	integer	✅	Index de base zéro de la ligne source.
`destinationRowIndex`	integer	✅	Index de base zéro où les lignes seront placées.
`rowNumber`	integer	✅	Nombre de lignes à copier.
`worksheet`	string	❌	Identifiant de la feuille de calcul ; généralement identique à sheetName.
`folder`	string	❌	Chemin vers le dossier contenant le classeur.
`storageName`	string	❌	Nom du service de stockage.

Exemple de requête (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/copy?sourceRowIndex=1&destinationRowIndex=12&rowNumber=10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>"

Remarque
Remplacer <jeton jwt> par un jeton JWT valide obtenu auprès du service d’authentification.

Réponse réussie

Code	Description
200	Lignes copiées avec succès.

{
  "Code": 200,
  "Status": "OK"
}

Le corps de la réponse est une instance de CellsCloudResponse.

Gestion des erreurs

Code HTTP	Signification	Corps d’exemple
400	Requête incorrecte – paramètres manquants ou non valides.	`{ "Code": 400, "Message": "sourceRowIndex non valide." }`
401	Non autorisé – jeton JWT invalide ou manquant.	`{ "Code": 401, "Message": "Échec de l’authentification." }`
404	Introuvable – le classeur ou la feuille de calcul n’existe pas.	`{ "Code": 404, "Message": "Fichier introuvable." }`
500	Erreur interne du serveur – condition inattendue du serveur.	`{ "Code": 500, "Message": "Une erreur inattendue s’est produite." }`

Directives de gestion

400 – Vérifier que tous les paramètres de requête obligatoires sont présents et correctement formatés.
401 – Régénérer ou actualiser le jeton JWT.
404 – Confirmer les noms du classeur et de la feuille de calcul, et vérifier que le fichier existe dans le dossier/le stockage spécifié.
500 – Réessayer après un court délai ; si le problème persiste, contacter le support Aspose.

Exemples de SDK

Les extraits suivants montrent comment appeler l’opération Copier des lignes à l’aide des SDK officiels Aspose.Cells Cloud.

Langage	Exemple
C#	Afficher le code `csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar api = new CellsApi("clientId", "clientSecret");\nawait api.PostCopyWorksheetRowsAsync(name: "test.xlsx", sheetName: "Sheet1", sourceRowIndex: 1, destinationRowIndex: 12, rowNumber: 10);\n`
Java	Afficher le code `java\nCellsApi api = new CellsApi("clientId", "clientSecret");\napi.postCopyWorksheetRows("test.xlsx", "Sheet1", 1, 12, 10, null, null, null);\n`
Python	Afficher le code `python\nfrom asposecellscloud import CellsApi\napi = CellsApi(client_id='clientId', client_secret='clientSecret')\napi.post_copy_worksheet_rows(name='test.xlsx', sheet_name='Sheet1', source_row_index=1, destination_row_index=12, row_number=10)\n`
Node.js	Afficher le code `javascript\nconst { CellsApi } = require('asposecellscloud');\nconst api = new CellsApi('clientId', 'clientSecret');\nawait api.postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Go	Afficher le code `go\nimport \"github.com/asposecellscloud/aspose-cells-cloud-go/v3\"\napi := cells.NewCellsApiClient(\"clientId\", \"clientSecret\")\n_, err := api.PostCopyWorksheetRows(context.Background(), \"test.xlsx\", \"Sheet1\", 1, 12, 10, nil, nil, nil)\n`
PHP	Afficher le code `php\nuse Aspose\Cells\CellsApi;\n$api = new CellsApi('clientId', 'clientSecret');\n$api->postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Ruby	Afficher le code `ruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::CellsApi.new('clientId', 'clientSecret')\napi.post_copy_worksheet_rows('test.xlsx', 'Sheet1', 1, 12, 10)\n`
Perl	Afficher le code `perl\nuse Aspose::Cells::CellsApi;\nmy $api = Aspose::Cells::CellsApi->new('clientId', 'clientSecret');\n$api->postCopyWorksheetRows(name => 'test.xlsx', sheetName => 'Sheet1', sourceRowIndex => 1, destinationRowIndex => 12, rowNumber => 10);\n`

Les fichiers sources complets sont disponibles sur le dépôt GitHub Aspose‑Cells‑Cloud.

Voir aussi

Page générée le {{DATE}}. Pour la version la plus récente de cette API, voir la spécification OpenAPI.