การปลดล็อกเวิร์กชีต Excel ที่ถูกป้องกันเป็นความต้องการที่พบบ่อยเมื่อทำการอัตโนมัติการประมวลผลข้อมูลหรือเตรียมรายงานสำหรับผู้ใช้ปลายทาง. Aspose.Cells Cloud SDK for .NET ให้ API ที่ทรงพลังซึ่งช่วยให้คุณสามารถลบการป้องกันของเวิร์กชีตได้โดยไม่ต้องทำการโต้ตอบด้วยตนเอง. ในคู่มือนี้คุณจะได้เรียนรู้วิธีการกำหนดค่า SDK, อัปโหลดเวิร์กบุ๊ก, เรียกใช้การดำเนินการปลดล็อก, และดึงไฟล์ที่ปลดล็อกแล้ว, ทั้งหมดพร้อมโค้ดที่พร้อมรันและตัวอย่าง cURL.

การตั้งค่า Aspose.Cells Cloud SDK สำหรับ .NET

ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

  • .NET 6.0 หรือใหม่กว่า ที่ติดตั้งแล้ว.
  • บัญชี Aspose Cloud พร้อม Client Id และ Client Secret.
  • เข้าถึงเทอร์มินัลหรือ IDE ที่คุณสามารถรันคำสั่ง .NET ได้.

ติดตั้ง SDK ผ่าน NuGet:

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 ยกเลิกการป้องกัน Worksheet

ขั้นตอนที่ 1: โหลดข้อมูลรับรองและสร้าง API Client

เริ่มต้นโดยดึง client ID และ secret ของคุณจาก environment แล้วสร้างอ็อบเจ็กต์ 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 storage. 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 ปลดล็อก Worksheet

โค้ดต่อไปนี้แสดงกระบวนการทั้งหมดในแอปพลิเคชันคอนโซลเดียว ใช้ 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}'.");
        }
    }
}

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ติดตั้งอย่างถูกต้อง และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดอ้างอิง เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

ปลดล็อกแผ่นงาน Excel ที่ได้รับการป้องกันด้วย cURL และ REST API

หากคุณไม่ต้องการเขียนโค้ด 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"

คำสั่งเหล่านี้ทำงานเดียวกันกับการ Aspose.Cells cloud .NET unprotect worksheet โดยใช้อินเทอร์เฟซ REST. สำหรับรายละเอียดเพิ่มเติม ดูที่ เอกสาร API อย่างเป็นทางการ.

การเพิ่มประสิทธิภาพการปลดล็อก Worksheet

  1. Reuse the CellsApi instance - การสร้างไคลเอนต์ใหม่สำหรับแต่ละคำขอทำให้เกิดภาระเพิ่มขึ้น ควรเก็บอินสแตนซ์เดียวไว้ตลอดอายุการทำงานของแอปพลิเคชันของคุณ.
  2. Stream files instead of loading them entirely into memory - เมธอด UploadFileAsync และ DownloadFileAsync ของ SDK ใช้สตรีมอยู่แล้ว ซึ่งช่วยลดภาระหน่วยความจำสำหรับสมุดงานขนาดใหญ่.
  3. Batch unprotect calls - หากคุณต้องการปลดล็อกหลายแผ่นงาน ให้ดึงรายการแผ่นงานครั้งเดียวแล้ววนลูปผ่าน UnprotectWorksheetAsync โดยไม่ต้องสอบถามสมุดงานใหม่ทุกครั้ง.
  4. Run the async methods without blocking - การใช้ await ทำให้เธรดสามารถทำงานอื่น ๆ ได้ในขณะที่การดำเนินการบนคลาวด์เสร็จสิ้น ช่วยปรับปรุงอัตราการทำงานโดยรวม.

สรุป

ความสามารถ Aspose.Cells cloud .NET unprotect worksheet ช่วยให้คุณสามารถลบการป้องกันจากแผ่นงาน Excel ได้โดยอัตโนมัติ ทำให้ง่ายต่อการผสานรวมในกระบวนการข้อมูลอัตโนมัติ โดยทำตามขั้นตอนข้างต้น คุณสามารถรับรองความถูกต้อง, อัปโหลด, ยกเลิกการป้องกัน, และดาวน์โหลดเวิร์กบุ๊กได้โดยใช้ .NET SDK หรือการเรียก REST โดยตรง จำไว้ว่าให้ได้รับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในผลิตภัณฑ์จริง; คุณสามารถเริ่มต้นด้วย หน้าลิขสิทธิ์ชั่วคราว ขณะประเมินผลิตภัณฑ์ สำหรับการสำรวจเพิ่มเติม ตรวจสอบเอกสาร Aspose.Cells Cloud SDK for .NET และทดลองใช้คุณสมบัติการจัดการแผ่นงานอื่น ๆ

คำถามที่พบบ่อย

  • Aspose.Cells cloud .NET unprotect worksheet ทำงานอย่างไรกับแผ่นงานที่มีการป้องกันด้วยรหัสผ่าน?
    เมื่อคุณส่งรหัสผ่านที่ถูกต้องในคำเรียก UnprotectWorksheetAsync API จะลบการป้องกันออก หากรหัสผ่านไม่ถูกต้องหรือไม่มีการระบุ จะได้รับการตอบกลับเป็นข้อผิดพลาด

  • ฉันสามารถปลดล็อกแผ่นงาน Excel ที่ถูกป้องกันโดยใช้ Aspose.Cells .NET โดยไม่ต้องเขียนโค้ดได้หรือไม่?
    ได้. การดำเนินการเดียวกันสามารถทำได้ผ่าน REST API โดยใช้ cURL หรือไคลเอนต์ HTTP ใด ๆ ตามที่แสดงในส่วน cURL ของบทความนี้.

  • ต้องการใบอนุญาตอะไรสำหรับ Aspose.Cells Cloud SDK for .NET ในการใช้งานจริง?
    จำเป็นต้องมีใบอนุญาตเชิงพาณิชย์สำหรับการปรับใช้ในสภาพแวดล้อมการผลิต คุณสามารถรับใบอนุญาตชั่วคราวจาก temporary license page ในระหว่างการทดสอบ

  • มีวิธีใดบ้างที่จะยกเลิกการป้องกันหลายแผ่นงานในเวิร์กบุ๊กเดียวเป็นชุดได้หรือไม่?
    คุณสามารถดึงรายการแผ่นงานด้วย GetWorkbookAsync และวนลูปผ่านแต่ละชื่อโดยเรียก UnprotectWorksheetAsync สำหรับแต่ละแผ่นงาน วิธีนี้ทำงานได้โดยใช้ SDK ในเชิงโปรแกรม