Déverrouiller une feuille de calcul Excel protégée est une exigence fréquente lors de l’automatisation du traitement des données ou de la préparation de rapports pour les utilisateurs finaux. Aspose.Cells Cloud SDK for .NET fournit une API puissante qui vous permet de supprimer la protection de la feuille de calcul sans intervention manuelle. Dans ce guide, vous apprendrez comment configurer le SDK, télécharger un classeur, appeler l’opération de déprotection et récupérer le fichier déverrouillé, le tout avec du code prêt à l’exécution et des exemples cURL.
Configuration de Aspose.Cells Cloud SDK for .NET
Avant de commencer, assurez‑vous d’avoir ce qui suit :
- .NET 6.0 ou version ultérieure installé.
- Un compte Aspose Cloud avec Client Id et Client Secret.
- Accès à un terminal ou à un IDE où vous pouvez exécuter des commandes .NET.
Installez le SDK via NuGet :
dotnet add package Aspense.cells-Cloud
Définissez vos informations d’identification en tant que variables d’environnement afin que le SDK puisse s’authentifier automatiquement :
// No additional code needed here; the SDK reads these variables at runtime.
Le SDK lira ASPOSE_CLIENT_ID et ASPOSE_CLIENT_SECRET depuis l’environnement. Après avoir installé le package et configuré les variables, vous êtes prêt à écrire du code qui interagit avec le stockage Aspose.Cells Cloud. La section suivante parcourt chaque étape de programmation.
Guide étape par étape pour Aspose.Cells Cloud .NET Déprotéger la feuille de calcul
Étape 1 : charger les informations d’identification et créer le client API
Pour commencer, récupérez votre ID client et votre secret depuis l’environnement et créez un objet Configuration. Cet objet est ensuite utilisé pour instancier CellsApi.
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");
var config = new Configuration
{
ClientId = clientId,
ClientSecret = clientSecret,
BasePath = "https://api.aspose.cloud"
};
var cellsApi = new CellsApi(config);
Étape 2 : Télécharger le classeur protégé
Téléchargez le fichier Excel local vers le stockage Aspose Cloud. Le SDK diffuse le fichier directement, évitant ainsi la nécessité de garder tout le fichier en mémoire.
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}
Étape 3 : Récupérer les informations du classeur et choisir une feuille de calcul
Après le téléchargement, demandez les métadonnées du classeur pour obtenir la liste des feuilles de calcul. Cet exemple sélectionne la première feuille, mais vous pouvez spécifier n’importe quel nom.
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
Étape 4 : Déprotéger la feuille de calcul
Appelez la méthode UnprotectWorksheetAsync, en passant le nom de la feuille de calcul et le mot de passe (ou null si aucun mot de passe n’est défini). C’est le cœur de l’opération Aspose.Cells cloud .NET unprotect worksheet.
string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);
Étape 5 : Télécharger le classeur mis à jour
Enfin, téléchargez le classeur modifié sur votre machine locale pour vérifier que la protection a été supprimée.
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Ces étapes illustrent un flux de travail complet Aspose.Cells cloud .NET unprotect worksheet, de l’authentification à la récupération du fichier.
Exemple complet fonctionnel pour Aspose.Cells Cloud .NET Déprotéger la feuille de calcul
Le code suivant montre l’ensemble du processus dans une application console unique. Il utilise async/await pour des E/S non bloquantes et démontre les meilleures pratiques telles que la vérification des erreurs après chaque appel d’API.
using System;
using System.IO;
using System.Threading.Tasks;
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Client;
using Aspose.Cells.Cloud.SDK.Model;
namespace AsposeCellsUnprotectDemo
{
class Program
{
static async Task Main(string[] args)
{
// Aspose Cloud credentials – set these environment variables before running
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");
var config = new Configuration
{
ClientId = clientId,
ClientSecret = clientSecret,
BasePath = "https://api.aspose.cloud"
};
var cellsApi = new CellsApi(config);
// Local file to upload (must exist) and remote storage details
string localInputPath = "ProtectedWorkbook.xlsx";
string remoteFolder = "Temp";
string remoteFileName = "ProtectedWorkbook.xlsx";
string remoteFilePath = $"{remoteFolder}/{remoteFileName}";
// Upload the protected workbook to Aspose Cloud storage
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
if (uploadResult == null || (uploadResult.Errors != null && uploadResult.Errors.Count > 0))
{
Console.WriteLine("Upload failed.");
return;
}
}
// Retrieve workbook information to get worksheet names
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
if (workbookResponse?.Workbook?.Worksheets == null || workbookResponse.Workbook.Worksheets.Count == 0)
{
Console.WriteLine("Unable to retrieve workbook or worksheets.");
return;
}
// Choose the first worksheet (or specify a name directly)
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
// Unprotect the worksheet – provide password if the sheet is password‑protected; otherwise null
string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);
if (unprotectResponse == null || unprotectResponse.Code != 200)
{
Console.WriteLine($"Failed to unprotect worksheet '{sheetName}'.");
return;
}
// Download the updated workbook
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
string localOutputPath = "UnprotectedWorkbook.xlsx";
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Console.WriteLine($"Worksheet '{sheetName}' has been unprotected and saved as '{localOutputPath}'.");
}
}
}
Note : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.
Déverrouillage d’une feuille Excel protégée avec cURL et l’API REST
Si vous préférez ne pas écrire du code C#, vous pouvez obtenir le même résultat avec des appels HTTP simples. Vous trouverez ci-dessous les commandes cURL requises.
- Obtenir un jeton d’accès
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Téléverser le classeur protégé
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- Déprotéger la feuille de calcul
curl -X POST "https://api.aspose.cloud/v3.0/cells/ProtectedWorkbook.xlsx/worksheets/Sheet1/unprotect?folder=Temp&password=myPassword" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Télécharger le classeur non protégé
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "UnprotectedWorkbook.xlsx"
Ces commandes effectuent la même opération Aspose.Cells cloud .NET unprotect worksheet en utilisant l’interface REST. Pour plus de détails, consultez la documentation officielle de l’API.
Optimisation des performances du déverrouillage de la feuille de calcul
- Réutilisez l’instance
CellsApi- créer un nouveau client pour chaque requête ajoute une surcharge. Conservez une seule instance pendant toute la durée de vie de votre application. - Diffusez les fichiers en flux plutôt que de les charger entièrement en mémoire - les méthodes
UploadFileAsyncetDownloadFileAsyncdu SDK utilisent déjà des flux, ce qui réduit la pression sur la mémoire pour les classeurs volumineux. - Regroupez les appels de déprotection - si vous devez déverrouiller de nombreuses feuilles de calcul, récupérez la liste des feuilles une fois et parcourez
UnprotectWorksheetAsyncsans re‑interroger le classeur à chaque fois. - Exécutez les méthodes asynchrones sans blocage - l’utilisation de
awaitpermet au thread de gérer d’autres tâches pendant que l’opération cloud se termine, améliorant le débit global.
Conclusion
La fonctionnalité Aspose.Cells cloud .NET unprotect worksheet vous permet de supprimer programmétiquement la protection des feuilles Excel, ce qui facilite son intégration dans des pipelines de données automatisés. En suivant les étapes ci‑dessus, vous pouvez vous authentifier, télécharger, désactiver la protection et télécharger des classeurs en utilisant soit le SDK .NET, soit des appels REST directs. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; vous pouvez commencer avec une page de licence temporaire lors de l’évaluation du produit. Pour aller plus loin, consultez la documentation du Aspose.Cells Cloud SDK for .NET et expérimentez d’autres fonctionnalités de manipulation de feuilles de calcul.
Foire aux questions
-
Comment la fonction unprotect worksheet d’Aspose.Cells cloud .NET gère-t-elle les feuilles protégées par mot de passe ?
Lorsque vous fournissez le mot de passe correct dans l’appelUnprotectWorksheetAsync, l’API supprime la protection. Un mot de passe incorrect ou manquant entraîne une réponse d’erreur. -
Puis-je déverrouiller une feuille Excel protégée en utilisant Aspose.Cells .NET sans écrire de code ?
Oui. La même opération peut être effectuée via l’API REST en utilisant cURL ou tout client HTTP, comme indiqué dans la section cURL de cet article. -
Quelle licence est requise pour Aspose.Cells Cloud SDK for .NET en production ?
Une licence commerciale est requise pour les déploiements en production. Vous pouvez obtenir une licence temporaire depuis la page de licence temporaire lors des tests. -
Existe-t-il un moyen de désactiver la protection de plusieurs feuilles de calcul en lot dans un même classeur ?
Vous pouvez récupérer la liste des feuilles de calcul avecGetWorkbookAsyncet itérer sur chaque nom, en appelantUnprotectWorksheetAsyncpour chaque feuille. Cette approche fonctionne programmatiquement avec le SDK.