إضافة توقيع رقمي إلى ملف Excel موقّع بالفعل

مقدمة

في عالمنا الرقمي اليوم، أصبح تأمين المستندات أكثر أهمية من أي وقت مضى. توفر التوقيعات الرقمية وسيلة لضمان صحة وسلامة ملفاتك، وخاصة عند التعامل مع معلومات حساسة. إذا كنت تعمل مع ملفات Excel وترغب في إضافة توقيع رقمي جديد إلى مصنف تم توقيعه بالفعل، فأنت في المكان المناسب! في هذا الدليل، سنرشدك خلال عملية إضافة توقيع رقمي إلى ملف Excel تم توقيعه بالفعل باستخدام Aspose.Cells for .NET. لذا، دعنا نبدأ!

المتطلبات الأساسية

قبل أن ننتقل إلى التفاصيل الدقيقة للترميز، هناك بعض الأشياء التي تحتاج إلى وضعها في مكانها:

Aspose.Cells لـ .NET: تأكد من تثبيت مكتبة Aspose.Cells في مشروع .NET الخاص بك. يمكنك تنزيلها من موقع .
ملف الشهادة: ستحتاج إلى ملف شهادة صالح (عادةً ما يكون.pfxالملف الذي يحتوي على الشهادة الرقمية الخاصة بك. تأكد من معرفة كلمة المرور لهذا الملف.
بيئة التطوير: قم بإعداد بيئة التطوير الخاصة بك باستخدام Visual Studio أو أي بيئة تطوير متكاملة أخرى تدعم .NET.
المعرفة الأساسية بلغة C#: ستساعدك المعرفة ببرمجة C# على المتابعة بسلاسة.
ملفات العينة: احرص على أن يكون لديك ملف Excel نموذجي موقّع رقميًا بالفعل. سيكون هذا هو الملف الذي ستضيف إليه توقيعًا جديدًا.

الآن بعد أن أصبح كل شيء في مكانه، فلنبدأ في البرمجة!

استيراد الحزم

للبدء، ستحتاج إلى استيراد الحزم اللازمة في ملف C# الخاص بك. وإليك كيفية القيام بذلك:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

ستتيح لك هذه المساحات الاسمية العمل مع ملفات Excel ومعالجة التوقيعات الرقمية بسلاسة.

الخطوة 1: إعداد أدلة المصدر والإخراج

قبل أن تتمكن من التعامل مع ملفات Excel، يتعين عليك تحديد مكان وجود ملفات المصدر والمكان الذي تريد حفظ ملف الإخراج فيه. وإليك كيفية القيام بذلك:

// دليل المصدر
string sourceDir = "Your Document Directory";
// دليل الإخراج
string outputDir = "Your Document Directory";

في هذه الخطوة، نستخدم طريقة للحصول على مسارات الدليلين المصدر والمخرج. تأكد من وجود هذين الدليلين واحتوائهما على الملفات المطلوبة.

الخطوة 2: تحميل المصنف الموقّع بالفعل

بعد ذلك، ستحتاج إلى تحميل مصنف Excel الذي تريد تعديله. يتم ذلك عن طريق إنشاء مثيل منWorkbook الفئة وتمرير مسار الملف الموقع.

// قم بتحميل المصنف الذي تم توقيعه رقميًا بالفعل
Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(sourceDir + "sampleDigitallySignedByCells.xlsx");

هنا، نقوم بتحميل المصنف المسمىsampleDigitallySignedByCells.xlsxتأكد من أن هذا الملف موقّع بالفعل.

الخطوة 3: إنشاء مجموعة توقيعات رقمية

الآن، لنبدأ في إنشاء مجموعة توقيعات رقمية. ستحتوي هذه المجموعة على كل التوقيعات الرقمية التي تريد إضافتها إلى المصنف.

// إنشاء مجموعة التوقيعات الرقمية
Aspose.Cells.DigitalSignatures.DigitalSignatureCollection dsCollection = new Aspose.Cells.DigitalSignatures.DigitalSignatureCollection();

تعتبر هذه الخطوة بالغة الأهمية لأنها تسمح لك بإدارة توقيعات متعددة إذا لزم الأمر.

الخطوة 4: إنشاء شهادة جديدة

يتعين عليك تحميل ملف الشهادة لإنشاء توقيع رقمي جديد. هذا هو المكان الذي تحدد فيه المسار إلى.pfx الملف وكلمة المرور الخاصة به.

// ملف الشهادة وكلمة المرور الخاصة به
string certFileName = sourceDir + "AsposeDemo.pfx";
string password = "aspose";

// إنشاء شهادة جديدة
System.Security.Cryptography.X509Certificates.X509Certificate2 certificate = new System.Security.Cryptography.X509Certificates.X509Certificate2(certFileName, password);

تأكد من الاستبدالAsposeDemo.pfxوكلمة المرور مع اسم ملف الشهادة الفعلي وكلمة المرور.

الخطوة 5: إنشاء التوقيع الرقمي

مع وجود الشهادة في متناول يدك، يمكنك الآن إنشاء توقيع رقمي. ستحتاج أيضًا إلى تقديم سبب التوقيع والتاريخ والوقت الحاليين.

// إنشاء توقيع رقمي جديد وإضافته إلى مجموعة التوقيعات الرقمية
Aspose.Cells.DigitalSignatures.DigitalSignature signature = new Aspose.Cells.DigitalSignatures.DigitalSignature(certificate, "Aspose.Cells added new digital signature in existing digitally signed workbook.", DateTime.Now);

تؤدي هذه الخطوة إلى إضافة التوقيع الجديد إلى مجموعتك، والذي ستطبقه لاحقًا على المصنف.

الخطوة 6: إضافة مجموعة التوقيعات الرقمية إلى المصنف

الآن حان الوقت لإضافة مجموعة التوقيعات الرقمية إلى المصنف. وهنا يحدث السحر!

// إضافة مجموعة التوقيعات الرقمية داخل المصنف
workbook.AddDigitalSignature(dsCollection);

من خلال تنفيذ هذا السطر، فإنك تقوم فعليًا بإرفاق التوقيع الرقمي الجديد بالمصنف الموقع بالفعل.

الخطوة 7: حفظ المصنف والتخلص منه

أخيرًا، قد ترغب في حفظ المصنف المعدّل في دليل الإخراج وتحرير أي موارد قيد الاستخدام.

//احفظ المصنف وتخلص منه.
workbook.Save(outputDir + "outputDigitallySignedByCells.xlsx");
workbook.Dispose();

تضمن هذه الخطوة حفظ التغييرات الخاصة بك، والتخلص من المصنف بشكل صحيح لتحرير الموارد.

الخطوة 8: تأكيد التنفيذ

ولتلخيص الأمر، من الجيد التأكد من تنفيذ الكود بنجاح. يمكنك القيام بذلك من خلال رسالة وحدة تحكم بسيطة.

Console.WriteLine("AddDigitalSignatureToAnAlreadySignedExcelFile executed successfully.\r\n");

يؤدي هذا إلى توفير ملاحظات تفيد بأن عمليتك كانت ناجحة، وهو أمر لطيف دائمًا أن نراه!

خاتمة

والآن، لقد نجحت في إضافة توقيع رقمي جديد إلى ملف Excel موقّع بالفعل باستخدام Aspose.Cells for .NET. تُعد التوقيعات الرقمية وسيلة فعّالة لضمان صحة مستنداتك، والآن تعرف كيفية إدارتها برمجيًا. سواء كنت تعمل على مستندات مالية أو عقود أو أي معلومات حساسة، فإن تنفيذ التوقيعات الرقمية يمكن أن يعزز الأمان والثقة.

الأسئلة الشائعة

ما هو التوقيع الرقمي؟

التوقيع الرقمي هو أسلوب تشفيري يستخدم للتحقق من صحة وسلامة الرسالة أو المستند.

هل يمكنني إضافة توقيعات رقمية متعددة إلى نفس ملف Excel؟

نعم، يمكنك إنشاء مجموعة توقيعات رقمية وإضافة توقيعات متعددة إلى نفس المصنف.

ما هي التنسيقات التي يدعمها Aspose.Cells للتوقيعات الرقمية؟

يدعم Aspose.Cells تنسيقات مختلفة، بما في ذلك.pfx للحصول على الشهادات.

هل أحتاج إلى إصدار محدد من .NET لاستخدام Aspose.Cells؟

التحقق من توثيق Aspose.Cells للتوافق مع إصدار .NET الخاص بك.

كيف يمكنني الحصول على ترخيص مؤقت لـ Aspose.Cells؟

يمكنك طلب ترخيص مؤقت من صفحة شراء Aspose .

Go Top