在自動化資料處理或為最終使用者準備報告時,解除受保護的 Excel 工作表是一項常見需求。 Aspose.Cells Cloud SDK for .NET 提供強大的 API,讓您無需手動操作即可移除工作表保護。在本指南中,您將學習如何設定 SDK、上傳工作簿、呼叫解除保護操作,並取得已解鎖的檔案,全部都有可直接執行的程式碼和 cURL 範例。

設定 Aspose.Cells Cloud SDK for .NET

在開始之前,請確保您已具備以下條件:

  • 已安裝 .NET 6.0 或更新版本。
  • 具備 Aspose Cloud 帳戶,且擁有 Client Id 與 Client Secret。
  • 可存取終端機或 IDE,以執行 .NET 指令。

透過 NuGet 安裝 SDK:

dotnet add package Aspose.cells-Cloud

將您的憑證設置為環境變數,以便 SDK 能自動驗證:

// No additional code needed here; the SDK reads these variables at runtime.

SDK 會從環境變數中讀取 ASPOSE_CLIENT_ID 和 ASPOSE_CLIENT_SECRET。安裝套件並設定變數後,您即可撰寫與 Aspose.Cells Cloud 儲存體互動的程式碼。下一節將逐步說明每個程式設計步驟。

Aspose.Cells Cloud .NET 解除工作表保護的逐步指南

步驟 1:載入憑證並建立 API 用戶端

首先,從環境變數中取得您的 client ID 和 secret,並建立一個 Configuration 物件。此物件隨後用於實例化 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);

第 2 步:上傳受保護的活頁簿

將本機 Excel 檔案上傳至 Aspose Cloud 儲存空間。SDK 會直接串流檔案,避免必須將整個檔案載入記憶體。

using (var fileStream = File.OpenRead(localInputPath))
{
    var uploadResult = await cellsApi.UploadFileAsync(remoteFilePath, fileStream);
}

步驟 3:檢索工作簿資訊並選擇工作表

上傳後,請求工作簿的中繼資料以取得工作表清單。此範例選取第一個工作表,但您可以指定任何名稱。

var workbookResponse = await cellsApi.GetWorkbookAsync(remoteFileName, folder: remoteFolder);
string sheetName = workbookResponse.Workbook.Worksheets[0].Name;

第 4 步:解除工作表保護

呼叫 UnprotectWorksheetAsync 方法,傳入工作表名稱和密碼(如果未設定密碼,則傳入 null)。這是 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);

步驟 5:下載已更新的工作簿

最後,將已修改的工作簿下載回本機,以驗證保護已被移除。

var downloadStream = await cellsApi.DownloadFileAsync(remoteFilePath);
using (var outputStream = File.Create(localOutputPath))
{
    await downloadStream.CopyToAsync(outputStream);
}

以下步驟說明了一個完整的 Aspose.Cells cloud .NET unprotect worksheet 工作流程,從驗證到檔案檢索。

Aspose.Cells Cloud .NET 解除工作表保護的完整範例

以下程式碼展示了在單一控制台應用程式中完整的流程。它使用 async/await 進行非阻塞 I/O,並示範了最佳實踐,例如在每個 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}'.");
        }
    }
}

注意: 此程式碼範例展示了核心功能。在將其用於您的專案之前,請確保更新任何檔案路徑和設定值以符合實際環境,驗證所有必要的相依項目已正確安裝,並在開發環境中徹底測試。如果遇到任何問題,請參閱官方文件或聯繫支援團隊以獲得協助。

使用 cURL 和 REST API 解鎖受保護的 Excel 工作表

如果您不想編寫 C# 程式碼,您可以使用純 HTTP 呼叫來達成相同的結果。以下是所需的 cURL 命令。

  1. 取得存取權杖
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. 上傳受保護的工作簿
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. 取消保護工作表
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. 下載未受保護的工作簿
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "UnprotectedWorkbook.xlsx"

這些指令使用 REST 介面執行相同的 Aspose.Cells cloud .NET unprotect worksheet 操作。欲了解更多細節,請參閱 官方 API 文件。

優化工作表解除保護效能

  1. Reuse the CellsApi instance - 為每個請求建立新客戶端會增加開銷。請在應用程式的整個生命週期內保留單一實例。
  2. Stream files instead of loading them entirely into memory - SDK 的 UploadFileAsync 與 DownloadFileAsync 方法已使用串流,能減少大型活頁簿的記憶體壓力。
  3. Batch unprotect calls - 如果需要解除保護多個工作表,請一次取得工作表清單,然後在 UnprotectWorksheetAsync 中迴圈處理,而不必每次都重新查詢活頁簿。
  4. Run the async methods without blocking - 使用 await 可讓執行緒在雲端操作完成期間處理其他工作,提升整體吞吐量。

總結

The Aspose.Cells cloud .NET unprotect worksheet 功能允許您以程式方式移除 Excel 工作表的保護,讓它輕鬆整合到自動化資料管道中。按照上述步驟,您可以使用 .NET SDK 或直接的 REST 呼叫來驗證、上傳、解除保護以及下載工作簿。請記得為正式環境取得適當的授權;在評估產品時,您可以先使用臨時授權頁面。如需進一步探索,請查閱 Aspose.Cells Cloud SDK for .NET 文件,並嘗試其他工作表操作功能。

常見問題

  • Aspose.Cells cloud .NET unprotect worksheet 如何處理受密碼保護的工作表?
    當您在 UnprotectWorksheetAsync 呼叫中提供正確的密碼時,API 會移除保護。若密碼不正確或缺失,則會返回錯誤回應。

  • 我可以在不編寫程式碼的情況下使用 Aspose.Cells .NET 解鎖受保護的 Excel 工作表嗎?
    是的。可以透過 REST API 使用 cURL 或任何 HTTP 客戶端執行相同的操作,如本文章的 cURL 部分所示。

  • 在生產環境中,Aspose.Cells Cloud SDK for .NET 需要什麼授權?
    生產部署需要商業授權。您可以在測試期間從臨時授權頁面取得臨時授權。

  • 是否有方法一次性批量取消保護工作簿中的多個工作表?
    您可以使用 GetWorkbookAsync 取得工作表清單,然後遍歷每個名稱,對每個工作表呼叫 UnprotectWorksheetAsync。此方法可在 SDK 中以程式方式運作。