مقدمة

أهلاً بك! إذا كنت تستكشف Aspose.Words لـ .NET وترغب في معرفة كيفية إضافة خصائص مستندات مخصصة إلى ملفات Word، فأنت في المكان المناسب. تُعد الخصائص المخصصة بالغة الأهمية لتخزين بيانات وصفية إضافية لا تغطيها الخصائص المدمجة. سواءً كنت بحاجة إلى تتبع تفويض المستندات، أو أرقام المراجعات، أو تواريخ محددة، فإن الخصائص المخصصة تُساعدك. في هذا البرنامج التعليمي، سنرشدك خلال خطوات إضافة هذه الخصائص بسلاسة باستخدام Aspose.Words لـ .NET. هيا بنا نبدأ!

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

قبل الغوص في الكود، تأكد من أن لديك ما يلي:

1. مكتبة Aspose.Words لـ .NET: قم بتنزيلها هنا.
2. بيئة التطوير: بيئة تطوير متكاملة مثل Visual Studio.
3. المعرفة الأساسية بلغة C#: المعرفة بلغة C# و.NET ستكون مفيدة.
4. مستند نموذجي: قم بإعداد مستند Word نموذجي باسم Properties.docx للتعديل.

استيراد مساحات الأسماء

للوصول إلى وظائف Aspose.Words، ستحتاج إلى استيراد المساحات الأساسية الضرورية في بداية الكود الخاص بك:

using System;
using Aspose.Words;

الخطوة 1: إعداد مسار المستند

بعد ذلك، دعنا نحدد مسار مستند Word الخاص بك. هذه الخطوة ضرورية للعثور على الملف وفتحه. Properties.docx ملف.

// حدد المسار إلى دليل المستندات الخاص بك.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document(dataDir + "Properties.docx");

تأكد من الاستبدال "YOUR DOCUMENT DIRECTORY" مع المسار الفعلي للمستند الخاص بك.

الخطوة 2: الوصول إلى خصائص المستند المخصصة

الآن، دعنا نصل إلى خصائص المستند المخصص لمستند Word، حيث ستتواجد بياناتك التعريفية المخصصة.

CustomDocumentProperties customDocumentProperties = doc.CustomDocumentProperties;

يتيح لك هذا السطر الوصول إلى مجموعة الخصائص المخصصة التي ستعمل عليها.

الخطوة 3: التحقق من العقارات الموجودة

قبل إضافة خصائص جديدة، من الحكمة التحقق مما إذا كانت الخاصية موجودة بالفعل لتجنب التكرار.

if (customDocumentProperties["Authorized"] != null) return;

يتحقق هذا الكود من وجود خاصية “مُصرَّح به” مسبقًا. في حال وجودها، تُغلق الدالة مبكرًا، مما يمنع تكرارها.

الخطوة 4: إضافة خاصية منطقية

دعنا نضيف خاصية منطقية مخصصة للإشارة إلى ما إذا كانت الوثيقة معتمدة أم لا.

customDocumentProperties.Add("Authorized", true);

يضيف هذا السطر خاصية تسمى “مصرح به” ويضبط قيمتها إلى true.

الخطوة 5: إضافة خاصية سلسلة

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

customDocumentProperties.Add("Authorized By", "John Smith");

لا تتردد في استبدال “جون سميث” بأي اسم تفضله.

الخطوة 6: إضافة خاصية التاريخ

لتتبع وقت اعتماد المستند، دعنا نضيف خاصية التاريخ.

customDocumentProperties.Add("Authorized Date", DateTime.Today);

يضيف هذا السطر خاصية تسمى “التاريخ المعتمد” ويعين لها تاريخ اليوم باستخدام DateTime.Today.

الخطوة 7: إضافة رقم المراجعة

للتحكم في الإصدار، يمكننا إضافة خاصية لتتبع رقم مراجعة المستند.

customDocumentProperties.Add("Authorized Revision", doc.BuiltInDocumentProperties.RevisionNumber);

هنا، نضيف خاصية “المراجعة المعتمدة” التي تحتوي على رقم المراجعة الحالية للمستند.

الخطوة 8: إضافة خاصية رقمية

أخيرًا، دعنا نضيف خاصية رقمية لتخزين المبلغ المصرح به، مثل رقم الميزانية.

customDocumentProperties.Add("Authorized Amount", 123.45);

يضيف هذا السطر خاصية تسمى “المبلغ المصرح به” بقيمة 123.45يمكنك تعديل هذا الرقم حسب الحاجة.

خاتمة

تهانينا! لقد نجحت في إضافة خصائص مستند مخصصة إلى مستند Word باستخدام Aspose.Words لـ .NET. تُعد هذه الخصائص طريقة فعّالة لتخزين البيانات الوصفية المُخصصة لمتطلباتك، سواءً كانت تتبُّع تفاصيل التفويض أو أرقام المراجعات أو كميات مُحددة.

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

ما هي خصائص المستند المخصصة؟

خصائص المستند المخصصة هي بيانات تعريفية يمكنك إضافتها إلى مستند Word لتخزين معلومات إضافية لا تغطيها الخصائص المضمنة.

هل يمكنني إضافة خصائص أخرى غير السلاسل والأرقام؟

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

كيف يمكنني الوصول إلى هذه الخصائص في مستند Word؟

بإمكانك الوصول إلى الخصائص المخصصة برمجيًا باستخدام Aspose.Words أو عرضها مباشرةً في Word من خلال خصائص المستند.

هل من الممكن تعديل أو حذف الخصائص المخصصة؟

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

هل يمكن استخدام الخصائص المخصصة لتصفية المستندات؟

نعم! الخصائص المخصصة ممتازة لتصنيف وتصفية المستندات بناءً على بيانات وصفية محددة.