დაცული 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 ბრძანებები.

დააყენეთ 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 კლიენტის შექმნა

დასაწყისისთვის, მიიღეთ თქვენი 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 სამუშაო ფურცლის განბლოკვა სამუშაო ნაკადს, ავტორიზაციიდან ფაილის მიღებამდე.

სრული სამუშაო მაგალითი 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 დოკუმენტაცია.

სამუშაო ფურცლის განბლოკვის შესრულების ოპტიმიზაცია

  1. CellsApi ინსტანსის თავიდან გამოყენება - ახალი კლიენტის შექმნა თითოეულ მოთხოვნაზე ზედმეტი დატვირთვას ქმნის. დატოვეთ ერთი ინსტანს თქვენი აპლიკაციის მთელი სიცოცხლის განმავლობაში.
  2. ფაილების ნაკადის გამოყენება, მათი სრულად მეხსიერებაში ჩატვირთვის ნაცვლად - SDK-ის UploadFileAsync და DownloadFileAsync მეთოდები უკვე იყენებენ ნაკადებს, რაც დიდი სამუშაო წიგნების მეხსიერების დატვირთვას იკლებთ.
  3. განბლოკვის ბაჩის გამოძახებები - თუ გჭირდებათ ბევრი სამუშაო ფურცლის განბლოკვა, მიიღეთ სამუშაო ფურცლების სია ერთხელ და გადახვიდეთ UnprotectWorksheetAsync‑ით, ყოველჯერ სამუშაო წიგნის თავიდან მოთხოვნის გარეშე.
  4. ასინქრონული მეთოდების გაშვება ბლოკირების გარეშე - await-ის გამოყენებით ნაკადი შეუძლია სხვა სამუშაოს შესრულება, სანამ ღრუბლული ოპერაცია დასრულდება, რაც საერთო წარმადობას გაუმჯობესებს.

დასკვნა

The Aspose.Cells cloud .NET unprotect worksheet შესაძლებლობა საშუალებას გაძლევთ პროგრამულად მოაცილოთ დაცვა Excel ფურცლებზე, რაც ადვილად ინტეგრირებას აძლევს ავტომატურ მონაცემთა ნაკადებში. ზემოთ მითითებული ნაბიჯების მიყოლით, შეგიძლიათ აუტენტიფიკაციით, ატვირთოთ, მოხსნათ დაცვა და გადმოწეროთ სამუშაო წიგნები .NET SDK-ის ან პირდაპირ REST მოთხოვნების გამოყენებით. გახსოვდეთ, რომ მიიღოთ შესაბამისი ლიცენზია წარმოებისთვის; შეგიძლიათ დაიწყოთ დროებითი ლიცენზიის გვერდი პროდუქტის შეფასებისას. დამატებითი შესწავლისთვის, გადახედეთ Aspose.Cells Cloud SDK for .NET დოკუმენტაციას და გამოცადეთ სხვა ფურცლების მანიპულაციის ფუნქციები.

ხშირად დასმული კითხვები

  • Aspose.Cells cloud .NET-ის UnprotectWorksheet ფუნქცია როგორ მუშაობს პაროლით დაცული ფურცლების შემთხვევაში?
    როდესაც UnprotectWorksheetAsync ფუნქციაში სწორ პაროლს გადაეცემა, API-ს შეუძლია დაცვა მოხსნას. არასწორი ან აკლია პაროლის შემთხვევაში, მიიღება შეცდომის პასუხი.

  • შეიძლება თუ არა განბლოკვა დაცული Excel ფურცელი Aspose.Cells .NET-ის გამოყენებით კოდის დაწერის გარეშე?
    დიახ. იგივე ოპერაცია შეიძლება შესრულდეს REST API-ის საშუალებით, იყენებთ cURL ან ნებისმიერი HTTP კლაიენტი, როგორც აღნიშნულია ამ სტატიის cURL განყოფილებაში.

  • Aspose.Cells Cloud SDK for .NET-ის წარმოებაში რა ლიცენზიაა საჭირო?
    კომერციული ლიცენზიაა საჭირო წარმოების განსახორციელებლად. ტესტირებისას შეგიძლიათ დროებით ლიცენზია მიიღოთ დროებითი ლიცენზიის გვერდიდან.

  • შეიძლება, რომ ერთ სამუშაო წიგნაკში მრავალ ცხრილის ერთდროულად მოხსნა იყოს?
    თქვენ შეგიძლიათ მიიღოთ ცხრილების სია GetWorkbookAsync ფუნქციის საშუალებით და გადახედოთ თითოეულ სახელზე, ყოველ ცხრილზე UnprotectWorksheetAsync ფუნქციის გამოძახებით. ეს მიდგომა მუშაობს პროგრამულად SDK-ის საშუალებით.