在自動化資料處理或為最終使用者準備報告時,解除受保護的 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 命令。
- 取得存取權杖
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- 上傳受保護的工作簿
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-T "ProtectedWorkbook.xlsx"
- 取消保護工作表
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"
- 下載未受保護的工作簿
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 文件。
優化工作表解除保護效能
- Reuse the
CellsApiinstance - 為每個請求建立新客戶端會增加開銷。請在應用程式的整個生命週期內保留單一實例。 - Stream files instead of loading them entirely into memory - SDK 的
UploadFileAsync與DownloadFileAsync方法已使用串流,能減少大型活頁簿的記憶體壓力。 - Batch unprotect calls - 如果需要解除保護多個工作表,請一次取得工作表清單,然後在
UnprotectWorksheetAsync中迴圈處理,而不必每次都重新查詢活頁簿。 - 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 中以程式方式運作。