Comment gérer la visibilité d'une feuille de calcul Excel
Contents
[
Hide
]
Gestion de la visibilité d’une feuille de calcul Excel
La visibilité de la feuille de calcul définit si une feuille est affichée à l’utilisateur final. Avec Aspose.Cells Cloud, vous pouvez masquer ou afficher une feuille de calcul via un appel REST simple. Les points de terminaison de l’API utilisés sont les suivants :
- Masquer une feuille de calcul –
PUT /cells/{fileName}/worksheets/{sheetName}/visibility - Afficher une feuille de calcul –
PUT /cells/{fileName}/worksheets/{sheetName}/visibility
Version d’API prise en charge : v3.0 (au mois de mars 2026)
Conditions préalables
- Un compte Aspose.Cells Cloud activé.
- Un identifiant client et un secret client valides (ou un jeton d’accès OAuth 2.0).
- Le classeur (
{fileName}) doit déjà être téléchargé dans le stockage cloud Aspose.
Masquer une feuille de calcul
Requête
PUT https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/visibility
Authorization: Bearer {access_token}
Content-Type: application/json
{
"Visible": false
}
Réponse
{
"Code": 200,
"Status": "OK",
"Worksheet": {
"Name": "{sheetName}",
"Index": 2,
"Visible": false
}
}
Exemple cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet2/visibility" \
-H "Authorization: Bearer VOTRE_JETON_D’ACCÈS" \
-H "Content-Type: application/json" \
-d '{ "Visible": false }'
Exemple .NET SDK
var api = new CellsApi("client_id", "client_secret");
var request = new Visibility { Visible = false };
var response = api.PutWorksheetVisibility("MyWorkbook.xlsx", "Sheet2", request);
Console.WriteLine($"Feuille de calcul masquée : {response.Worksheet.Visible}");
Erreurs courantes
| Code HTTP | Description | Mesure correctrice |
|---|---|---|
| 400 | Corps JSON invalide ou champ Visible manquant |
Vérifiez que le corps de la requête est un JSON valide contenant la clé. |
| 401 | Non autorisé – jeton manquant ou expiré | Actualisez le jeton OAuth et incluez-le dans l’en-tête. |
| 404 | Feuille de calcul ou fichier introuvable | Vérifiez que {fileName} et {sheetName} sont corrects. |
| 409 | Feuille de calcul déjà masquée | Vérifiez la visibilité actuelle avant d’envoyer la requête. |
Afficher une feuille de calcul
Requête
PUT https://api.aspose.cloud/v3.0/cells/{fileName}/worksheets/{sheetName}/visibility
Authorization: Bearer {access_token}
Content-Type: application/json
{
"Visible": true
}
Réponse
{
"Code": 200,
"Status": "OK",
"Worksheet": {
"Name": "{sheetName}",
"Index": 2,
"Visible": true
}
}
Exemple cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet2/visibility" \
-H "Authorization: Bearer VOTRE_JETON_D’ACCÈS" \
-H "Content-Type: application/json" \
-d '{ "Visible": true }'
Exemple .NET SDK
var api = new CellsApi("client_id", "client_secret");
var request = new Visibility { Visible = true };
var response = api.PutWorksheetVisibility("MyWorkbook.xlsx", "Sheet2", request);
Console.WriteLine($"Feuille de calcul affichée : {response.Worksheet.Visible}");
Erreurs courantes
| Code HTTP | Description | Mesure correctrice |
|---|---|---|
| 400 | Corps JSON invalide ou champ Visible manquant |
Fournissez une charge utile JSON correcte contenant "Visible": true. |
| 401 | Non autorisé – jeton manquant ou expiré | Régénérez le jeton d’accès et réessayez. |
| 404 | Feuille de calcul ou fichier introuvable | Vérifiez que le fichier et le nom de la feuille existent dans le stockage. |
| 409 | Feuille de calcul déjà affichée | Aucune action nécessaire ; la feuille est déjà visible. |
Opérations associées
Geler les volets | Découper les volets | Zoom – consultez les pages correspondantes pour des contrôles supplémentaires de mise en page des feuilles de calcul.
Questions fréquentes
- Comment masquer une feuille de calcul à l’aide de l’API Aspose.Cells Cloud ?
- Envoyez une requête `PUT` vers `/cells/{fileName}/worksheets/{sheetName}/visibility` avec le corps JSON `{ "Visible": false }`. Incluez un jeton porteur OAuth 2.0 valide. Une réponse `200 OK` renvoie l’objet feuille de calcul mis à jour.
- Quelle réponse reçoit-on après avoir affiché une feuille de calcul ?
- L’API renvoie `200 OK` avec une charge utile contenant l’objet feuille de calcul où `"Visible": true`. La réponse inclut les propriétés `Name`, `Index` et `Visible` de la feuille de calcul.
- Puis-je masquer plusieurs feuilles de calcul en une seule requête ?
- Non. Le point de terminaison de visibilité fonctionne sur une seule feuille de calcul identifiée par `{sheetName}`. Pour masquer plusieurs feuilles, parcourez chaque nom dans votre code client.
Rédigé par l’équipe Aspose Docs – plus de 15 ans d’expérience dans l’automatisation des flux de travail Excel.