Det er ofte nødvendigt at låse beskyttelsen op for et beskyttet Excel‑regneark, når man automatiserer databehandling eller forbereder rapporter til slutbrugere. Aspose.Cells Cloud SDK for .NET leverer et kraftfuldt API, der gør det muligt at fjerne regnearksbeskyttelse uden manuel indgriben. I denne vejledning vil du lære, hvordan du konfigurerer SDK’en, uploader en projektmappe, kalder unprotect‑operationen og henter den låste fil, alt sammen med klar‑til‑kørsel kode og cURL‑eksempler.
Opsætning af Aspose.Cells Cloud SDK for .NET
Før du starter, skal du sikre dig, at du har følgende:
- .NET 6.0 eller nyere installeret.
- En Aspose Cloud-konto med Client Id og Client Secret.
- Adgang til en terminal eller IDE, hvor du kan køre .NET-kommandoer.
Installer SDK’en via NuGet:
dotnet add package Aspose.cells-Cloud
Indstil dine legitimationsoplysninger som miljøvariabler, så SDK’et kan godkende automatisk:
// No additional code needed here; the SDK reads these variables at runtime.
SDK’en vil læse ASPOSE_CLIENT_ID og ASPOSE_CLIENT_SECRET fra miljøet. Efter at have installeret pakken og konfigureret variablerne, er du klar til at skrive kode, der interagerer med Aspose.Cells Cloud-lagring. Næste afsnit gennemgår hvert programmerings trin.
Trin-for-trin guide til Aspose.Cells Cloud .NET Fjern beskyttelse af regneark
Trin 1: Indlæs legitimationsoplysninger og opret API-klienten
For at begynde, hent din klient-ID og hemmelighed fra miljøet og opret et Configuration-objekt. Dette objekt bruges derefter til at instantiere 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);
Trin 2: Upload den beskyttede arbejdsbog
Upload den lokale Excel-fil til Aspose Cloud-lagring. SDK’en streamer filen direkte, så du undgår at skulle holde hele filen i hukommelsen.
using (var fileStream = File.OpenRead(localInputPath))
{
var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}
Trin 3: Hent arbejdsbogsoplysninger og vælg et regneark
Efter upload skal du anmode om arbejdsbogens metadata for at få listen over regneark. Dette eksempel vælger det første ark, men du kan angive et hvilket som helst navn.
var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;
Trin 4: Fjern beskyttelse af regnearket
Kald metoden UnprotectWorksheetAsync, og send regnearkets navn og adgangskode (eller null, hvis der ikke er nogen adgangskode). Dette er kernen i Aspose.Cells cloud .NET unprotect worksheet operationen.
string password = "myPassword"; // replace with actual password or set to null
var unprotectResponse = await cellsApi.UnprotectWorksheetAsync(remoteFileName, sheetName, password, remoteFolder);
Trin 5: Download den opdaterede projektmappe
Endelig skal du downloade den modificerede projektmappe tilbage til din lokale maskine for at bekræfte, at beskyttelsen er fjernet.
var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
await downloadStream.CopyToAsync(outputStream);
}
Disse trin illustrerer en komplet Aspose.Cells cloud .NET unprotect worksheet arbejdsflow, fra godkendelse til filhentning.
Fuldstændigt fungerende eksempel for Aspose.Cells Cloud .NET Fjern beskyttelse af regneark
Den følgende kode viser hele processen i en enkelt konsolapplikation. Den bruger async/await til ikke‑blokerende I/O og demonstrerer bedste praksis såsom fejlkontrol efter hvert API‑kald.
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}'.");
}
}
}
Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sikre dig, at du opdaterer eventuelle filstier og konfigurationsværdier, så de matcher dit faktiske miljø, bekræfter at alle nødvendige afhængigheder er korrekt installeret, og tester grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så henvis til den officielle dokumentation eller kontakt supportteamet for assistance.
Oplåsning af beskyttet Excel-ark med cURL og REST API
Hvis du foretrækker ikke at skrive C#‑kode, kan du opnå det samme resultat med almindelige HTTP‑kald. Nedenfor er de nødvendige cURL‑kommandoer.
- Få en adgangstoken
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Upload den beskyttede projektmappe
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- Fjern beskyttelsen af regnearket
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"
- Download den ubeskyttede projektmappe
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "UnprotectedWorkbook.xlsx"
Disse kommandoer udfører den samme Aspose.Cells cloud .NET unprotect worksheet operation ved hjælp af REST‑grænsefladen. For flere detaljer, se den officielle API‑dokumentation.
Optimering af ydeevnen ved fjernelse af beskyttelse af regneark
- Genbrug
CellsApi‑instansen – oprettelse af en ny klient for hver anmodning tilføjer overhead. Hold en enkelt instans i hele applikationens levetid. - Stream filer i stedet for at indlæse dem fuldstændigt i hukommelsen – SDK’ens
UploadFileAsyncogDownloadFileAsync‑metoder bruger allerede streams, hvilket reducerer hukommelsesbelastningen for store regneark. - Batch‑opkald til unprotect – hvis du skal låse mange regneark op, så hent regnearkslisten én gang og gennemløb
UnprotectWorksheetAsyncuden at forespørge regnearket igen hver gang. - Kør de asynkrone metoder uden at blokere – brug af
awaitgør, at tråden kan håndtere andet arbejde, mens cloud‑operationen fuldføres, hvilket forbedrer den samlede gennemløbshastighed.
Afslutning
Aspose.Cells cloud .NET unprotect worksheet‑funktionen giver dig mulighed for programmatisk at fjerne beskyttelse fra Excel‑ark, hvilket gør det nemt at integrere i automatiserede datapipelines. Ved at følge trinnene ovenfor kan du godkende, uploade, fjerne beskyttelse og downloade arbejdsbøger ved hjælp af enten .NET SDK’en eller direkte REST‑kald. Husk at skaffe en korrekt licens til produktionsbrug; du kan starte med en temporary license page mens du evaluerer produktet. For yderligere udforskning, se dokumentationen for Aspose.Cells Cloud SDK for .NET og eksperimentér med andre funktioner til manipulation af regneark.
Ofte stillede spørgsmål
-
Hvordan håndterer Aspose.Cells cloud .NET unprotect worksheet beskyttede ark med adgangskode?
Når du angiver den korrekte adgangskode iUnprotectWorksheetAsync-kaldet, fjerner API’en beskyttelsen. En forkert eller manglende adgangskode resulterer i et fejlsvar. -
Kan jeg låse et beskyttet Excel-ark op ved hjælp af Aspose.Cells .NET uden at skrive kode?
Ja. Den samme handling kan udføres via REST API’et ved hjælp af cURL eller en hvilken som helst HTTP-klient, som vist i cURL‑sektionen i denne artikel. -
What licensing is required for Aspose.Cells Cloud SDK for .NET in production?
En kommerciel licens er påkrævet til produktionsimplementeringer. Du kan få en midlertidig licens fra den midlertidige licensside under test. -
Er der en måde at batch fjerne beskyttelsen for flere regneark i én projektmappe?
Du kan hente listen over regneark medGetWorkbookAsyncog iterere over hvert navn, og kaldeUnprotectWorksheetAsyncfor hvert ark. Denne tilgang fungerer programmatisk med SDK’en.