การปลดล็อกเวิร์กชีต 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 ที่จำเป็น.
- รับโทเคนการเข้าถึง
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"
คำสั่งเหล่านี้ทำงานเดียวกันกับการ Aspose.Cells cloud .NET unprotect worksheet โดยใช้อินเทอร์เฟซ REST. สำหรับรายละเอียดเพิ่มเติม ดูที่ เอกสาร API อย่างเป็นทางการ.
การเพิ่มประสิทธิภาพการปลดล็อก Worksheet
- Reuse the
CellsApiinstance - การสร้างไคลเอนต์ใหม่สำหรับแต่ละคำขอทำให้เกิดภาระเพิ่มขึ้น ควรเก็บอินสแตนซ์เดียวไว้ตลอดอายุการทำงานของแอปพลิเคชันของคุณ. - Stream files instead of loading them entirely into memory - เมธอด
UploadFileAsyncและDownloadFileAsyncของ SDK ใช้สตรีมอยู่แล้ว ซึ่งช่วยลดภาระหน่วยความจำสำหรับสมุดงานขนาดใหญ่. - Batch unprotect calls - หากคุณต้องการปลดล็อกหลายแผ่นงาน ให้ดึงรายการแผ่นงานครั้งเดียวแล้ววนลูปผ่าน
UnprotectWorksheetAsyncโดยไม่ต้องสอบถามสมุดงานใหม่ทุกครั้ง. - 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 ทำงานอย่างไรกับแผ่นงานที่มีการป้องกันด้วยรหัสผ่าน?
เมื่อคุณส่งรหัสผ่านที่ถูกต้องในคำเรียกUnprotectWorksheetAsyncAPI จะลบการป้องกันออก หากรหัสผ่านไม่ถูกต้องหรือไม่มีการระบุ จะได้รับการตอบกลับเป็นข้อผิดพลาด -
ฉันสามารถปลดล็อกแผ่นงาน Excel ที่ถูกป้องกันโดยใช้ Aspose.Cells .NET โดยไม่ต้องเขียนโค้ดได้หรือไม่?
ได้. การดำเนินการเดียวกันสามารถทำได้ผ่าน REST API โดยใช้ cURL หรือไคลเอนต์ HTTP ใด ๆ ตามที่แสดงในส่วน cURL ของบทความนี้. -
ต้องการใบอนุญาตอะไรสำหรับ Aspose.Cells Cloud SDK for .NET ในการใช้งานจริง?
จำเป็นต้องมีใบอนุญาตเชิงพาณิชย์สำหรับการปรับใช้ในสภาพแวดล้อมการผลิต คุณสามารถรับใบอนุญาตชั่วคราวจาก temporary license page ในระหว่างการทดสอบ -
มีวิธีใดบ้างที่จะยกเลิกการป้องกันหลายแผ่นงานในเวิร์กบุ๊กเดียวเป็นชุดได้หรือไม่?
คุณสามารถดึงรายการแผ่นงานด้วยGetWorkbookAsyncและวนลูปผ่านแต่ละชื่อโดยเรียกUnprotectWorksheetAsyncสำหรับแต่ละแผ่นงาน วิธีนี้ทำงานได้โดยใช้ SDK ในเชิงโปรแกรม