كيفية حماية ملف باستخدام Aspose.Cells Cloud

المقدمة

تُعد واجهة برمجة تطبيقات Aspose.Cells Cloud حلًّا قويًّا يُستند إلى الحوسبة السحابية، مُصمَّم خصيصًا لإنشاء وتعديل وتحويل ملفات الجداول الحسابية. في هذه المقالة، سنُرشدك خطوة بخطوة حول كيفية استخدام واجهة برمجة تطبيقات Aspose.Cells Cloud لحماية الملفات، مع تضمين حالات الاستخدام الشائعة وأمثلة على أكواد برمجية.

نظرة عامة

تقدم واجهة برمجة تطبيقات Aspose.Cells Cloud مجموعةً من الواجهات القوية لحماية ملفات Excel أو الجداول الحسابية. باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud، يمكنك بسهولة حماية ملفات Excel أو ملفات جداول حسابية أخرى، لتلبية متطلبات متنوعة.

تتوفر العديد من الواجهات لحماية الملفات، وتتوافق عمومًا مع بيئات عبر الإنترنت متنوعة. فيما يلي وصف مفصّل لهذه الواجهات:

الوظيفة الوصف مرجع الواجهة
حماية جدول حسابي حماية جدول حسابي. PostProtect
إلغاء حماية جدول حسابي إلغاء حماية جدول حسابي. DeleteUnprotect
  • يوضح الجدول التالي واجهات ميزة الحماية للإصدار 3.0.
وصف الوظيفة وثيقة التطوير وظيفة الواجهة
تأمين ملفات Microsoft Excel وOpenDocument Spreadsheet عبر تطبيق حماية بكلمة مرور. دليل التطوير PostEncryptWorkbook
حماية ملفات Microsoft Excel وOpenDocument Spreadsheet. دليل التطوير PostProtectWorkbook
حماية ملفات Microsoft Excel وOpenDocument Spreadsheet دون استخدام تخزين سحابي. دليل التطوير PostProtect
التوقيع الرقمي لملفات Microsoft Excel وOpenDocument Spreadsheet. دليل التطوير PostDigitalSignature
حماية الملفات دفعةً واحدة. دليل التطوير PostBatchProtect

كيفية حماية ملف Excel باستخدام Aspose.Cells Cloud

تقدم واجهة برمجة تطبيقات Aspose.Cells Cloud عدة SDKs تدعم لغات برمجة مختلفة. اختر SDK يتوافق مع لغة البرمجة التي تفضلها، واتبع الوثائق المرفقة لتثبيته وتهيئته. كخيار بديل، يمكنك صُنع SDK مخصص وفقًا لـمرجع الواجهة. في هذا القسم، سنستخدم لغة C# كمثال لتوضيح عملية حماية الملفات بالتفصيل.

التسجيل والحصول على مفتاح API

قبل البدء، تحتاج إلى تسجيل حساب في Aspose Cloud والحصول على مفتاح API للاستخدام في المصادقة. بعد تسجيل الدخول إلى الموقع الرسمي لـ Aspose Cloud، يمكنك إنشاء حساب مجاني والحصول على مفتاح API لأغراض المصادقة.

للاطلاع على عمليات أكثر تقدمًا، يُرجى الرجوع إلى الوثائق التالية: البدء السريع مع Cells Cloud

تثبيت وتهيئة SDK لـ Aspose.Cells Cloud

قم بتثبيت حزمة Aspose.Cells-Cloud NuGet ضمن مشروع .NET الخاص بك، ويمكنك استخدام وحدة تحكم NuGet Package Manager أو مدير الحزم NuGet في Visual Studio. إليك كيفية تثبيت الحزمة باستخدام وحدة تحكم Package Manager Console:


Install-Package Aspose.Cells-Cloud

قم بإنشاء مثيل جديد للفئة CellsApi، وقم بتهيئته باستخدام معرّف العميل وسر معرّف العميل (Client ID وClient Secret). فيما يلي تفاصيل مقتطف الكود السابق:


CellsApi cellsInstance = new CellsApi(clientID, clientSecret);

تأكد من استبدال YOUR_API_KEY وYOUR_APP_SID وYOUR_APP_KEY بمفتاح API الفعلي ومعرّف التطبيق (Application SID) ومفتاح التطبيق (Application Key) الخاصين بك.

بناء طلب الواجهة واستدعاء الواجهة

يقوم هذا الكود بإنشاء مثيل جديد للكائن PostProtectRequest، ويُهيئه باستخدام الملفات المطلوبة وطلب حماية Workbook. ثم يستدعي واجهة الحماية باستخدام طلب الحماية هذا. وتدعم دالة الحماية أيضًا معلّمات استعلام موسّعة. فيما يلي تفاصيل مقتطف الكود السابق:


CellsApi cellsApi = new CellsApi(Environment.GetEnvironmentVariable("ProductClientId"), Environment.GetEnvironmentVariable("ProductClientSecret"));
cellsApi.ProtectSpreadsheet(new ProtectSpreadsheetRequest { Spreadsheet = "Book1.xlsx" , password= "123456" , modifyPassword ="654321" } , "ProtectedBook1.xlsx");

حالات الاستخدام

ميزة حماية ملفات Excel أو ملفات جداول حسابية أخرى تُعد مفيدة في العديد من الحالات العملية. فيما يلي بعض السيناريوهات الشائعة:

  • إضافة توقيعات رقمية متعددة لملفات Excel المحلية أو ملفات جداول حسابية أخرى.
  • إضافة حماية بكلمة مرور لملفات Excel المحلية أو ملفات جداول حسابية أخرى.
  • تعيين خيار Always Open Read-Only لتسهيل المشاركة.
  • دمج ملفات متعددة في ملف HTML واحد لعرضها أو تضمينها في صفحات الويب.

الخلاصة

باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud، يمكنك بسهولة إجراء عمليات حماية لملفات Excel أو ملفات جداول حسابية أخرى. ومن خلال إجراء مكالمات بسيطة لواجهة API وضبط خيارات الحماية المناسبة، يمكنك الوفاء بكافة متطلبات دمج وحماية الملفات بكفاءة. قم بدمج واجهة برمجة تطبيقات Aspose.Cells Cloud في تطبيقاتك لتعزيز الإنتاجية وتوفير وقت التطوير.

يرجى ملاحظة أن كود المثال أعلاه مخصّص لأغراض التوضيح فقط، وستحتاج إلى استبداله ببيانات اعتماد مصادقة صالحة ومسارات ملفات حقيقية عند الاستخدام في التطبيقات العملية. علاوةً على ذلك، توفر واجهة برمجة تطبيقات Aspose.Cells Cloud العديد من الميزات الأخرى، مثل إنشاء الجداول الحسابية وتعديلها و manipulationsها ومعالجة بياناتها. يمكنك الاطّلاع على وثائق الواجهة التفصيلية وأكواد الأمثلة على دليل المطوّرين على الموقع الرسمي لـ Aspose.

نأمل أن تساعدك هذه المقالة على فهم كيفية استخدام واجهة برمجة تطبيقات Aspose.Cells Cloud لحماية الملفات. نتمنى لك التوفيق في تنفيذ الحلول!