Mở khóa một worksheet Excel được bảo vệ là một yêu cầu thường gặp khi tự động hoá xử lý dữ liệu hoặc chuẩn bị báo cáo cho người dùng cuối. Aspose.Cells Cloud SDK for .NET cung cấp một API mạnh mẽ cho phép bạn gỡ bỏ bảo vệ worksheet mà không cần tương tác thủ công. Trong hướng dẫn này, bạn sẽ học cách cấu hình SDK, tải lên một workbook, gọi thao tác unprotect và lấy lại tệp đã được mở khóa, tất cả đều kèm theo mã sẵn sàng chạy và các ví dụ cURL.

Cài đặt Aspose.Cells Cloud SDK cho .NET

Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có những thứ sau:

  • Đã cài đặt .NET 6.0 hoặc phiên bản mới hơn.
  • Một tài khoản Aspose Cloud với Client Id và Client Secret.
  • Truy cập vào terminal hoặc IDE nơi bạn có thể chạy các lệnh .NET.

Cài đặt SDK qua NuGet:

dotnet add package Aspose.cells-Cloud

Đặt thông tin xác thực của bạn dưới dạng biến môi trường để SDK có thể tự động xác thực:

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

SDK sẽ đọc ASPOSE_CLIENT_ID và ASPOSE_CLIENT_SECRET từ môi trường. Sau khi cài đặt gói và cấu hình các biến, bạn đã sẵn sàng viết mã tương tác với lưu trữ Aspose.Cells Cloud. Phần tiếp theo sẽ hướng dẫn từng bước lập trình.

Hướng dẫn từng bước để Aspose.Cells Cloud .NET Bỏ bảo vệ Worksheet

Bước 1: Tải thông tin xác thực và tạo API Client

Để bắt đầu, lấy client ID và secret của bạn từ môi trường và xây dựng một đối tượng Configuration. Đối tượng này sau đó được sử dụng để khởi tạo 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);

Bước 2: Tải lên Workbook được bảo vệ

Tải tệp Excel cục bộ lên bộ nhớ lưu trữ Aspose Cloud. SDK sẽ truyền luồng tệp trực tiếp, tránh việc phải giữ toàn bộ tệp trong bộ nhớ.

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

Bước 3: Lấy Thông Tin Workbook và Chọn Worksheet

Sau khi tải lên, yêu cầu siêu dữ liệu workbook để lấy danh sách các worksheet. Ví dụ này chọn sheet đầu tiên, nhưng bạn có thể chỉ định bất kỳ tên nào.

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

Bước 4: Bỏ bảo vệ Worksheet

Gọi phương thức UnprotectWorksheetAsync, truyền tên worksheet và mật khẩu (hoặc null nếu không có mật khẩu được đặt). Đây là phần cốt lõi của thao tác 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);

Bước 5: Tải xuống Workbook đã cập nhật

Cuối cùng, tải xuống workbook đã chỉnh sửa về máy tính cục bộ của bạn để xác minh rằng bảo vệ đã bị xóa.

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

Các bước này minh họa quy trình Aspose.Cells cloud .NET unprotect worksheet hoàn chỉnh, từ xác thực đến việc truy xuất tệp.

Ví dụ Hoạt động đầy đủ cho Aspose.Cells Cloud .NET Unprotect Worksheet

Mã sau đây hiển thị toàn bộ quá trình trong một ứng dụng console duy nhất. Nó sử dụng async/await cho I/O không chặn và minh họa các thực tiễn tốt nhất như kiểm tra lỗi sau mỗi lời gọi 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}'.");
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội ngũ hỗ trợ để được trợ giúp.

Mở khóa Bảng tính Excel được bảo vệ bằng cURL và REST API

Nếu bạn không muốn viết mã C#, bạn có thể đạt được kết quả tương tự bằng các cuộc gọi HTTP thuần. Dưới đây là các lệnh cURL cần thiết.

  1. Lấy token truy cập
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. Tải lên workbook được bảo vệ
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. Bỏ bảo vệ trang tính
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. Tải xuống workbook không được bảo vệ
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/Temp/ProtectedWorkbook.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "UnprotectedWorkbook.xlsx"

Các lệnh này thực hiện cùng một thao tác Aspose.Cells cloud .NET unprotect worksheet bằng giao diện REST. Để biết thêm chi tiết, xem tài liệu API chính thức.

Tối ưu hóa hiệu suất bỏ bảo vệ Worksheet

  1. Tái sử dụng thể hiện CellsApi - tạo một client mới cho mỗi yêu cầu sẽ gây tốn kém. Giữ một thể hiện duy nhất trong suốt vòng đời của ứng dụng.
  2. Dòng dữ liệu thay vì tải toàn bộ vào bộ nhớ - các phương thức UploadFileAsync và DownloadFileAsync của SDK đã sử dụng stream, giúp giảm áp lực bộ nhớ cho các workbook lớn.
  3. Gộp các lời gọi unprotect - nếu bạn cần mở khóa nhiều worksheet, hãy lấy danh sách worksheet một lần và lặp qua UnprotectWorksheetAsync mà không cần truy vấn lại workbook mỗi lần.
  4. Chạy các phương thức async mà không chặn - sử dụng await cho phép luồng xử lý công việc khác trong khi thao tác đám mây hoàn thành, cải thiện thông lượng tổng thể.

Kết luận

Khả năng Aspose.Cells cloud .NET unprotect worksheet cho phép bạn gỡ bỏ bảo vệ khỏi các sheet Excel một cách lập trình, giúp dễ dàng tích hợp vào các quy trình dữ liệu tự động. Bằng cách làm theo các bước ở trên, bạn có thể xác thực, tải lên, gỡ bảo vệ và tải xuống các workbook bằng .NET SDK hoặc các cuộc gọi REST trực tiếp. Hãy nhớ mua giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; bạn có thể bắt đầu với một trang giấy phép tạm thời trong quá trình đánh giá sản phẩm. Để khám phá thêm, hãy xem tài liệu của Aspose.Cells Cloud SDK for .NET và thử nghiệm các tính năng thao tác worksheet khác.

Câu hỏi thường gặp

  • Aspose.Cells cloud .NET unprotect worksheet xử lý các sheet được bảo vệ bằng mật khẩu như thế nào?
    Khi bạn cung cấp mật khẩu đúng trong lời gọi UnprotectWorksheetAsync, API sẽ gỡ bỏ bảo vệ. Mật khẩu không đúng hoặc thiếu sẽ dẫn đến phản hồi lỗi.

  • Tôi có thể mở khóa một sheet Excel được bảo vệ bằng Aspose.Cells .NET mà không cần viết mã không?
    Có. Thao tác tương tự có thể được thực hiện thông qua REST API bằng cURL hoặc bất kỳ client HTTP nào, như đã được trình bày trong phần cURL của bài viết này.

  • Cần giấy phép nào cho Aspose.Cells Cloud SDK for .NET khi triển khai trong môi trường sản xuất?
    Cần một giấy phép thương mại cho các triển khai trong môi trường sản xuất. Bạn có thể lấy giấy phép tạm thời từ trang giấy phép tạm thời khi đang thử nghiệm.

  • Có cách nào để gỡ bảo vệ hàng loạt nhiều worksheet trong một workbook không?
    Bạn có thể lấy danh sách các worksheet bằng GetWorkbookAsync và lặp qua từng tên, gọi UnprotectWorksheetAsync cho mỗi sheet. Cách tiếp cận này hoạt động theo chương trình với SDK.