إضافة طابع التاريخ والوقت في ملف PDF
مقدمة
عندما يتعلق الأمر بإدارة المستندات، وخاصة ملفات PDF، فإن إضافة ختم التاريخ والوقت يمكن أن يكون بمثابة تغيير جذري. سواء كنت تعمل على مستندات قانونية أو تقارير مشروع أو فواتير، فإن ختم التاريخ لا يضيف المصداقية فحسب، بل يوفر أيضًا سجلًا واضحًا لوقت إنشاء المستند أو تعديله. في هذا الدليل، سنرشدك خلال عملية إضافة ختم التاريخ والوقت إلى ملف PDF باستخدام مكتبة Aspose.PDF لـ .NET.
تم تصميم هذه المقالة لتكون واضحة وسهلة المتابعة، لذا حتى إذا كنت جديدًا في البرمجة أو مكتبة Aspose.PDF، فستتمكن من تنفيذ هذه الميزة بثقة. لنبدأ!
المتطلبات الأساسية
قبل أن نبدأ، هناك بعض المتطلبات الأساسية التي يجب أن تتوفر لديك:
- Visual Studio: تأكد من تثبيت Visual Studio على جهازك. هذا هو المكان الذي ستكتب فيه التعليمات البرمجية وتنفذها.
- Aspose.PDF for .NET: تحتاج إلى تنزيل مكتبة Aspose.PDF وتثبيتها. يمكنك العثور على أحدث إصدارهنا.
- المعرفة الأساسية بلغة C#: ستساعدك المعرفة ببرمجة C# على فهم الأمثلة بشكل أفضل، ولكن لا تقلق إذا كنت بدأت للتو؛ فسنشرح كل شيء خطوة بخطوة.
- ملف PDF: جهز ملف PDF كعينة. في مثالنا، سنستخدم ملفًا باسم
AddTextStamp.pdf
.
بمجرد حصولك على هذه المتطلبات الأساسية، ستكون جاهزًا لبدء إضافة طوابع التاريخ والوقت إلى ملفات PDF الخاصة بك!
استيراد الحزم
للبدء، تحتاج إلى استيراد مساحات الأسماء الضرورية في مشروع C# الخاص بك. وإليك كيفية القيام بذلك:
إنشاء مشروع جديد
- افتح Visual Studio: قم بتشغيل تطبيق Visual Studio الخاص بك.
- إنشاء مشروع جديد: حدد “إنشاء مشروع جديد” من شاشة البدء.
- اختر تطبيق وحدة التحكم: حدد “تطبيق وحدة التحكم (.NET Framework)” من قائمة قوالب المشروع.
- قم بتسمية مشروعك: قم بتسمية مشروعك، على سبيل المثال،
PDFDateTimeStamp
.
إضافة مرجع Aspose.PDF
- انقر بزر الماوس الأيمن فوق المراجع: في مستكشف الحلول، انقر بزر الماوس الأيمن فوق مجلد “المراجع” الخاص بمشروعك.
- حدد “إضافة مرجع”: اختر “إضافة مرجع” من قائمة السياق.
- استعرض Aspose.PDF: انتقل إلى الموقع الذي قمت بتنزيل Aspose.PDF منه وحدده. انقر فوق “موافق” لإضافته إلى مشروعك.
استيراد المساحات المطلوبة
في الجزء العلوي منProgram.cs
الملف، تحتاج إلى استيراد المساحات التالية:
using System.IO;
using Aspose.Pdf;
using Aspose.Pdf.Text;
using System;
using Aspose.Pdf.Annotations;
الآن بعد أن قمنا بإعداد كل شيء، دعنا نقوم بتقسيم عملية إضافة طابع التاريخ والوقت إلى ملف PDF إلى خطوات واضحة وقابلة للإدارة.
الخطوة 1: تعيين دليل المستندات
أولاً، عليك تحديد الدليل الذي يوجد به ملف PDF الخاص بك. وهذا أمر بالغ الأهمية لأن الكود سيبحث عن ملف PDF في هذا الدليل.
// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY"; // استبدل بالمسار الفعلي الخاص بك
تأكد من الاستبدالYOUR DOCUMENT DIRECTORY
مع المسار الفعلي لملف PDF الخاص بك.
الخطوة 2: افتح مستند PDF
بعد ذلك، ستفتح مستند PDF الذي تريد إضافة الطابع الزمني إليه.
// فتح المستند
Document pdfDocument = new Document(dataDir + "AddTextStamp.pdf");
يقوم هذا السطر من التعليمات البرمجية بتهيئةDocument
قم بتحميل ملف PDF الخاص بك إلى الفصل الدراسيpdfDocument
هدف.
الخطوة 3: إنشاء طابع التاريخ والوقت
الآن حان الوقت لإنشاء طابع التاريخ والوقت. عليك تنسيقه لعرضه بطريقة معينة.
string annotationText = DateTime.Now.ToString("MM/dd/yy hh:mm:ss tt ");
هنا،DateTime.Now
يحصل على التاريخ والوقت الحاليين، وToString
تنسيقه إلى التنسيق المطلوب.
الخطوة 4: إنشاء ختم نصي
بعد إعداد سلسلة التاريخ والوقت، يمكنك الآن إنشاء طابع نصي سيتم إضافته إلى ملف PDF الخاص بك.
// إنشاء ختم نصي
TextStamp textStamp = new TextStamp(annotationText);
يؤدي هذا الخط إلى إنشاء مثيل جديد لـTextStamp
باستخدام سلسلة التاريخ والوقت المنسقة.
الخطوة 5: تعيين خصائص الختم
يمكنك تخصيص مظهر الختم وموضعه. وإليك كيفية ضبط خصائصه:
// تعيين خصائص الطوابع
textStamp.BottomMargin = 10;
textStamp.RightMargin = 20;
textStamp.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Right;
textStamp.VerticalAlignment = VerticalAlignment.Bottom;
في هذه الخطوة، قمنا بتعيين الهوامش ومحاذاة الختم إلى الزاوية اليمنى السفلية لصفحة PDF.
الخطوة 6: إضافة الختم إلى ملف PDF
الآن حان الوقت لإضافة ختم النص إلى مستند PDF الخاص بك.
// إضافة طابع إلى مجموعة الطوابع
pdfDocument.Pages[1].AddStamp(textStamp);
يضيف هذا السطر الطابع إلى الصفحة الأولى من ملف PDF. يمكنك تغيير رقم الصفحة إذا كنت تريد وضعه في صفحة مختلفة.
الخطوة 7: إنشاء تعليق نصي مجاني (اختياري)
إذا كنت تريد إضافة تعليق توضيحي إلى الختم، يمكنك إنشاءFreeTextAnnotation
على النحو التالي:
DefaultAppearance default_appearance = new DefaultAppearance("Arial", 6, System.Drawing.Color.Black);
FreeTextAnnotation textAnnotation = new FreeTextAnnotation(pdfDocument.Pages[1], new Aspose.Pdf.Rectangle(0, 0, 0, 0), default_appearance);
textAnnotation.Name = "Stamp";
textAnnotation.Accept(new AnnotationSelector(textAnnotation));
textAnnotation.Contents = textStamp.Value;
تؤدي هذه الخطوة الاختيارية إلى إنشاء تعليق نصي مجاني يمكنه توفير سياق أو معلومات إضافية حول الطابع.
الخطوة 8: تكوين حدود التعليقات التوضيحية
إذا كنت تريد تخصيص حدود التعليقات التوضيحية الخاصة بك، فيمكنك القيام بذلك أيضًا:
Border border = new Border(textAnnotation);
border.Width = 0;
border.Dash = new Dash(1, 1);
textAnnotation.Border = border;
textAnnotation.Rect = new Aspose.Pdf.Rectangle(0, 0, 0, 0);
pdfDocument.Pages[1].Annotations.Add(textAnnotation);
يقوم مقتطف التعليمات البرمجية هذا بتعيين عرض الحدود إلى 0، مما يجعلها غير مرئية، ويضيف التعليق التوضيحي إلى ملف PDF.
الخطوة 9: احفظ مستند PDF
وأخيرًا، يتعين عليك حفظ مستند PDF المعدّل.
dataDir = dataDir + "AddDateTimeStamp_out.pdf"; // حدد اسم ملف الإخراج
pdfDocument.Save(dataDir);
Console.WriteLine("\nDate time stamp added successfully.\nFile saved at " + dataDir);
يحفظ هذا السطر ملف PDF الذي يحتوي على الطابع الزمني المضاف في ملف جديد. يمكنك التحقق من الدليل المحدد لمعرفة الناتج.
خاتمة
تهانينا! لقد نجحت في إضافة طابع تاريخ ووقت إلى ملف PDF باستخدام Aspose.PDF for .NET. يمكن لهذه الميزة البسيطة والفعّالة تحسين مستنداتك، وجعلها أكثر احترافية وتوفير سجل واضح لوقت إنشائها أو تعديلها.
الأسئلة الشائعة
هل يمكنني تخصيص تنسيق التاريخ في الطابع الزمني؟
نعم يمكنك تعديلToString
طريقة لتغيير تنسيق التاريخ حسب تفضيلاتك.
هل استخدام Aspose.PDF مجاني؟
يقدم Aspose.PDF نسخة تجريبية مجانية، ولكن للحصول على الميزات الكاملة، تحتاج إلى شراء ترخيص. يمكنك الحصول على ترخيص مؤقتهنا.
هل يمكنني إضافة عدة طوابع زمنية إلى ملف PDF؟
بالتأكيد! يمكنك إنشاء العديد منTextStamp
قم بنسخ الحالات وإضافتها إلى صفحات أو مواضع مختلفة في ملف PDF.
ماذا لو لم يكن لدي Visual Studio؟
يمكنك استخدام أي C# IDE أو محرر نصوص، ولكن لتشغيل مشروعك وتصحيح أخطائه، يوصى باستخدام Visual Studio.
أين يمكنني العثور على المزيد من الأمثلة لاستخدام Aspose.PDF؟
يمكنك استكشاف المزيد من الأمثلة والبرامج التعليمية فيتوثيق Aspose.PDF.