פתיחת הגנה על גיליון 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

כדי להתחיל, קבל את מזהה הלקוח והסוד שלך מהסביבה ובנה אובייקט 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 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}'.");
        }
    }
}

הערה: הדוגמה של קוד זה מדגימה את הפונקציונליות המרכזית. לפני השימוש בה בפרויקט שלך, ודא שאתה מעדכן את כל נתיבי הקבצים וערכי ההגדרות כך שיתאימו לסביבה האמיתית שלך, אמת שכל התלויות הנדרשות מותקנות כראוי, ובצע בדיקות מקיפות בסביבת הפיתוח שלך. אם אתה נתקל בבעיות, אנא פנה לתיעוד רשמי או פנה לצוות התמיכה לקבלת סיוע.

פתיחת גיליון 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. הזרם קבצים במקום לטעון אותם במלואם לזיכרון - המתודות UploadFileAsync ו-DownloadFileAsync של ה‑SDK כבר משתמשות בזרמים, מה שמפחית את הלחץ על הזיכרון עבור חוברות עבודה גדולות.
  3. בצע קריאות unprotect במקבץ - אם עליך לשחרר הגנה ממספר רב של גיליונות, קבל את רשימת הגיליונות פעם אחת ועבור על UnprotectWorksheetAsync ללא שאילתת חוברת העבודה מחדש בכל פעם.
  4. הפעל את המתודות האסינכרוניות ללא חסימה - שימוש ב-await מאפשר לחוט לטפל בעבודה אחרת בזמן שהפעולה בענן מסתיימת, ומשפר את קצב העיבוד הכולל.

סיכום

היכולת Aspose.Cells cloud .NET unprotect worksheet מאפשרת לך להסיר הגנה משורות Excel באופן תכנותי, מה שמקל על אינטגרציה בצינורות נתונים אוטומטיים. על‑ידי ביצוע השלבים שלמעלה, תוכל לאמת, להעלות, להסיר הגנה ולהוריד חוברות עבודה באמצעות SDK של .NET או קריאות 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.