Sbloccare un foglio di lavoro Excel protetto è una necessità frequente quando si automatizza l’elaborazione dei dati o si preparano report per gli utenti finali. Aspose.Cells Cloud SDK for .NET fornisce un’API potente che consente di rimuovere la protezione del foglio di lavoro senza interazione manuale. In questa guida imparerai come configurare l’SDK, caricare una cartella di lavoro, chiamare l’operazione di sblocco e recuperare il file sbloccato, il tutto con codice pronto all’esecuzione ed esempi cURL.
Configurazione di Aspose.Cells Cloud SDK for .NET
Prima di iniziare, assicurati di avere quanto segue:
- .NET 6.0 o versioni successive installati.
- Un account Aspose Cloud con Client Id e Client Secret.
- Accesso a un terminale o IDE dove è possibile eseguire comandi .NET.
Installa l’SDK tramite NuGet:
dotnet add package Aspose.cells-Cloud
Imposta le tue credenziali come variabili d’ambiente in modo che l’SDK possa autenticarsi automaticamente:
// No additional code needed here; the SDK reads these variables at runtime.
Il SDK leggerà ASPOSE_CLIENT_ID e ASPOSE_CLIENT_SECRET dall’ambiente. Dopo aver installato il pacchetto e configurato le variabili, sei pronto a scrivere codice che interagisce con lo storage di Aspose.Cells Cloud. La sezione successiva illustra ogni passaggio di programmazione.
Guida passo passo per rimuovere la protezione del foglio di lavoro con Aspose.Cells Cloud .NET
Passo 1: Carica le credenziali e crea il client API
Per iniziare, recupera il tuo client ID e il segreto dall’ambiente e crea un oggetto Configuration. Questo oggetto viene quindi utilizzato per istanziare 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);
Passo 2: Carica la cartella di lavoro protetta
Carica il file Excel locale nello storage di Aspose Cloud. L’SDK trasmette il file in streaming direttamente, evitando la necessità di mantenere l’intero file in memoria.
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}
Passo 3: Recupera le informazioni della cartella di lavoro e scegli un foglio di lavoro
Dopo il caricamento, richiedi i metadati della cartella di lavoro per ottenere l’elenco dei fogli di lavoro. Questo esempio seleziona il primo foglio, ma è possibile specificare qualsiasi nome.
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
Passo 4: Rimuovere la protezione del foglio di lavoro
Chiama il metodo UnprotectWorksheetAsync, passando il nome del foglio di lavoro e la password (o null se non è impostata alcuna password). Questo è il nucleo dell’operazione 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);
Passo 5: Scarica la cartella di lavoro aggiornata
Infine, scarica la cartella di lavoro modificata sul tuo computer locale per verificare che la protezione sia stata rimossa.
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Questi passaggi illustrano un flusso di lavoro completo Aspose.Cells cloud .NET unprotect worksheet, dall’autenticazione al recupero del file.
Esempio completo funzionante per Aspose.Cells Cloud .NET Unprotect Worksheet
Il codice seguente mostra l’intero processo in una singola applicazione console. Utilizza async/await per I/O non bloccante e dimostra le migliori pratiche, come il controllo degli errori dopo ogni chiamata 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}'.");
}
}
}
Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.
Sblocco di un foglio Excel protetto con cURL e l’API REST
Se preferisci non scrivere codice C#, puoi ottenere lo stesso risultato con semplici chiamate HTTP. Di seguito sono riportati i comandi cURL richiesti.
- Ottenere un token di accesso
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Carica la cartella di lavoro protetta
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- Rimuovere la protezione del foglio di lavoro
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"
- Scarica la cartella di lavoro non protetta
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "UnprotectedWorkbook.xlsx"
Questi comandi eseguono la stessa operazione Aspose.Cells cloud .NET unprotect worksheet utilizzando l’interfaccia REST. Per ulteriori dettagli, consulta la documentazione ufficiale dell’API.
Ottimizzazione delle prestazioni di sblocco del foglio di lavoro
- Riutilizza l’istanza
CellsApi- creare un nuovo client per ogni richiesta aggiunge overhead. Mantieni un’unica istanza per tutta la durata della tua applicazione. - Trasmetti i file in streaming invece di caricarli interamente in memoria - i metodi
UploadFileAsynceDownloadFileAsyncdell’SDK usano già gli stream, il che riduce la pressione sulla memoria per cartelle di lavoro di grandi dimensioni. - Esegui chiamate di unprotect in batch - se devi sbloccare molti fogli di lavoro, recupera l’elenco dei fogli una volta e itera su
UnprotectWorksheetAsyncsenza rieseguire la query sul workbook ogni volta. - Esegui i metodi asincroni senza bloccare - usare
awaitconsente al thread di gestire altro lavoro mentre l’operazione cloud è in corso, migliorando il throughput complessivo.
Conclusione
La funzionalità Aspose.Cells cloud .NET unprotect worksheet consente di rimuovere programmaticamente la protezione dai fogli Excel, facilitando l’integrazione in pipeline di dati automatizzate. Seguendo i passaggi sopra, è possibile autenticarsi, caricare, rimuovere la protezione e scaricare le cartelle di lavoro utilizzando sia il .NET SDK sia chiamate REST dirette. Ricorda di ottenere una licenza adeguata per l’uso in produzione; puoi iniziare con una pagina di licenza temporanea durante la valutazione del prodotto. Per ulteriori approfondimenti, consulta la documentazione del Aspose.Cells Cloud SDK for .NET e sperimenta con altre funzionalità di manipolazione dei fogli di lavoro.
Domande frequenti
-
Come gestisce Aspose.Cells cloud .NET la rimozione della protezione di un foglio di lavoro con password?
Quando fornisci la password corretta nella chiamataUnprotectWorksheetAsync, l’API rimuove la protezione. Una password errata o assente genera una risposta di errore. -
Posso sbloccare un foglio Excel protetto usando Aspose.Cells .NET senza scrivere codice?
Sì. La stessa operazione può essere eseguita tramite la REST API usando cURL o qualsiasi client HTTP, come mostrato nella sezione cURL di questo articolo. -
Quale licenza è necessaria per Aspose.Cells Cloud SDK for .NET in produzione?
È necessaria una licenza commerciale per le distribuzioni in produzione. È possibile ottenere una licenza temporanea dalla pagina della licenza temporanea durante i test. -
Esiste un modo per rimuovere la protezione di più fogli di lavoro in batch in una cartella di lavoro?
È possibile recuperare l’elenco dei fogli di lavoro conGetWorkbookAsynce iterare su ogni nome, chiamandoUnprotectWorksheetAsyncper ogni foglio. Questo approccio funziona programmaticamente con l’SDK.