باز کردن قفل یک برگه‌کار محافظت‌شده اکسل یک نیاز متداول هنگام خودکارسازی پردازش داده‌ها یا تهیه گزارش‌ها برای کاربران نهایی است. 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 را اجرا کنید.

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 حذف محافظت از برگه کاری

مرحله 1: بارگذاری اعتبارها و ایجاد کلاینت API

برای شروع، شناسه کلاینت و رمز عبور خود را از محیط دریافت کنید و یک شیء 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);

مرحله ۲: بارگذاری کتاب‌کار محافظت‌شده

فایل 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;

مرحله ۴: حذف حفاظت از برگه کاری

متد 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 برای ورودی/خروجی غیر مسدودکننده استفاده می‌کند و بهترین شیوه‌ها مانند بررسی خطا پس از هر فراخوانی 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

اگر ترجیح می‌دهید کد 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 مراجعه کنید.

بهینه‌سازی عملکرد رفع محافظت از کاربرگ

  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 به شما امکان می‌دهد تا به‌صورت برنامه‌نویسی محافظت را از شیت‌های اکسل حذف کنید و ادغام آن را در خطوط داده خودکار آسان می‌سازد. با دنبال کردن مراحل بالا، می‌توانید با استفاده از .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 چه مجوزی لازم است؟
    برای استقرارهای تولیدی به یک مجوز تجاری نیاز است. می‌توانید در حین تست، یک مجوز موقت را از صفحه صفحه مجوز موقت دریافت کنید.

  • آیا راهی برای حذف محافظت دسته‌جمعی چندین برگه کاری در یک دفتر کار وجود دارد؟
    می‌توانید فهرست برگه‌های کاری را با GetWorkbookAsync دریافت کنید و بر روی هر نام تکرار کنید، به‌طوری‌که برای هر برگه UnprotectWorksheetAsync را فراخوانی کنید. این روش به‌صورت برنامه‌نویسی با SDK کار می‌کند.