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.

  1. 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"
  1. 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"
  1. 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"
  1. 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

  1. Genbrug CellsApi‑instansen – oprettelse af en ny klient for hver anmodning tilføjer overhead. Hold en enkelt instans i hele applikationens levetid.
  2. Stream filer i stedet for at indlæse dem fuldstændigt i hukommelsen – SDK’ens UploadFileAsync og DownloadFileAsync‑metoder bruger allerede streams, hvilket reducerer hukommelsesbelastningen for store regneark.
  3. Batch‑opkald til unprotect – hvis du skal låse mange regneark op, så hent regnearkslisten én gang og gennemløb UnprotectWorksheetAsync uden at forespørge regnearket igen hver gang.
  4. Kør de asynkrone metoder uden at blokere – brug af await gø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 i UnprotectWorksheetAsync-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 med GetWorkbookAsync og iterere over hvert navn, og kalde UnprotectWorksheetAsync for hvert ark. Denne tilgang fungerer programmatisk med SDK’en.