فتح حماية ورقة عمل Excel محمية هو طلب شائع عند أتمتة معالجة البيانات أو إعداد التقارير للمستخدمين النهائيين. Aspose.Cells Cloud SDK for .NET يوفر واجهة برمجة تطبيقات قوية تتيح لك إزالة حماية ورقة العمل دون تفاعل يدوي. في هذا الدليل ستتعلم كيفية تكوين SDK، تحميل مصنف، استدعاء عملية إلغاء الحماية، واسترجاع الملف غير المحمي، كل ذلك مع كود جاهز للتنفيذ وأمثلة cURL.
إعداد Aspose.Cells Cloud SDK for .NET
قبل أن تبدأ، تأكد من أن لديك ما يلي:
- تم تثبيت .NET 6.0 أو أحدث.
- حساب Aspose Cloud مع معرف العميل و سر العميل.
- الوصول إلى طرفية أو بيئة تطوير متكاملة حيث يمكنك تشغيل أوامر .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 لإجراء عمليات 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 الرسمية.
تحسين أداء إلغاء حماية ورقة العمل
- إعادة استخدام مثيل
CellsApi- إنشاء عميل جديد لكل طلب يضيف عبئًا إضافيًا. احتفظ بمثيل واحد طوال عمر تطبيقك. - بث الملفات بدلاً من تحميلها بالكامل في الذاكرة - طرق SDK
UploadFileAsyncوDownloadFileAsyncتستخدم البث بالفعل، مما يقلل من ضغط الذاكرة للدفاتر الكبيرة. - تنفيذ استدعاءات إلغاء الحماية على دفعات - إذا كنت بحاجة إلى فتح العديد من أوراق العمل، استرجع قائمة أوراق العمل مرة واحدة وتكرار عبر
UnprotectWorksheetAsyncدون إعادة استعلام الدفتر في كل مرة. - تشغيل الأساليب غير المتزامنة دون حجب - استخدام
awaitيسمح للخيط بمعالجة أعمال أخرى أثناء إكمال عملية السحابة، مما يحسن الإنتاجية العامة.
الختام
تتيح لك قدرة Aspose.Cells cloud .NET unprotect worksheet إزالة الحماية من أوراق Excel برمجيًا، مما يجعل من السهل دمجها في خطوط البيانات الآلية. باتباع الخطوات المذكورة أعلاه، يمكنك المصادقة، والتحميل، وإزالة الحماية، وتنزيل المصنفات باستخدام إما .NET SDK أو استدعاءات REST المباشرة. تذكر أن تحصل على ترخيص مناسب للاستخدام في الإنتاج؛ يمكنك البدء بصفحة الترخيص المؤقت أثناء تقييم المنتج. للمزيد من الاستكشاف، راجع وثائق Aspose.Cells Cloud SDK for .NET وجرب ميزات أخرى لمعالجة الأوراق.
الأسئلة المتكررة
-
كيف يتعامل Aspose.Cells cloud .NET إلغاء حماية ورقة العمل مع الأوراق المحمية بكلمة مرور؟
عند تزويدك بكلمة المرور الصحيحة في استدعاءUnprotectWorksheetAsync، تقوم الواجهة البرمجية بإزالة الحماية. كلمة مرور غير صحيحة أو مفقودة تؤدي إلى استجابة خطأ. -
هل يمكنني إلغاء حماية ورقة Excel محمية باستخدام Aspose.Cells .NET دون كتابة كود؟
نعم. يمكن تنفيذ العملية نفسها عبر واجهة برمجة التطبيقات REST باستخدام cURL أو أي عميل HTTP، كما هو موضح في قسم cURL من هذه المقالة. -
ما هو الترخيص المطلوب لـ Aspose.Cells Cloud SDK for .NET في بيئة الإنتاج؟
يتطلب الترخيص التجاري للنشر في الإنتاج. يمكنك الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت أثناء الاختبار. -
هل هناك طريقة لإلغاء حماية عدة أوراق عمل دفعة واحدة في مصنف واحد؟
يمكنك استرداد قائمة أوراق العمل باستخدامGetWorkbookAsyncوالتكرار على كل اسم، واستدعاءUnprotectWorksheetAsyncلكل ورقة. هذا النهج يعمل برمجياً مع SDK.