العمل مع خصائص الوثيقة
تسمح خصائص المستند بتخزين بعض المعلومات المفيدة حول مستندك. ويمكن تقسيم هذه الخصائص إلى مجموعتين:
- النظام أو المدمج الذي يحتوي على قيم مثل عنوان المستند واسم المؤلف وإحصائيات المستند وغيرها.
- معرف من قبل المستخدم أو مخصص، يتم توفيره كأزواج اسم وقيمة حيث يمكن للمستخدم تحديد كل من الاسم والقيمة.
من المفيد معرفة أن المعلومات المتعلقة بـ API ورقم الإصدار تتم كتابتها مباشرة لإخراج المستندات. على سبيل المثال، عند تحويل مستند إلى PDF، يقوم Aspose.Words بملء حقل “Application” بـ “Aspose.Words”، وحقل “PDF Producer” بـ “Aspose.Words for .NET YY.MN”، حيث يكون YY.M.N هو إصدار Aspose.Words المستخدم للتحويل. لمزيد من التفاصيل، راجع اسم المولد أو المنتج مدرج في مستندات الإخراج.
الوصول إلى خصائص المستند
للوصول إلى خصائص المستند في Aspose.Words، استخدم:
-
BuiltInDocumentProperties للحصول على الخصائص المضمنة.
-
CustomDocumentProperties للحصول على الخصائص المخصصة.
BuiltInDocumentProperties وCustomDocumentProperties عبارة عن مجموعات من كائنات DocumentProperty. يمكن الحصول على هذه الكائنات من خلال خاصية المفهرس بالاسم أو بالفهرس.
يوفر BuiltInDocumentProperties أيضًا إمكانية الوصول إلى خصائص المستند من خلال مجموعة من الخصائص المدخلة التي تُرجع قيمًا من النوع المناسب. يمكّنك CustomDocumentProperties من إضافة أو إزالة خصائص المستند من المستند.
تتيح لك فئة DocumentProperty الحصول على اسم وقيمة ونوع خاصية المستند. تقوم Value بإرجاع كائن، ولكن هناك مجموعة من الأساليب التي تسمح لك بتحويل قيمة الخاصية إلى نوع معين. بعد أن تتعرف على نوع الخاصية، يمكنك استخدام إحدى طرق DocumentProperty.ToXXX، مثل DocumentProperty.ToString وDocumentProperty.ToInt، للحصول على قيمة النوع المناسب.
يوضح مثال التعليمات البرمجية التالي كيفية تعداد كافة الخصائص المضمنة والمخصصة في مستند:
في Microsoft Word، يمكنك الوصول إلى خصائص المستند باستخدام القائمة “ملف → خصائص”.
إضافة أو إزالة خصائص المستند
لا يمكنك إضافة أو إزالة خصائص المستند المضمنة باستخدام Aspose.Words. يمكنك فقط تغيير أو تحديث قيمها.
لإضافة خصائص مستند مخصصة باستخدام Aspose.Words، استخدم طريقة Add، وقم بتمرير اسم الخاصية الجديد وقيمة النوع المناسب. تقوم الطريقة بإرجاع كائن DocumentProperty المنشأ حديثًا.
لإزالة الخصائص المخصصة، استخدم طريقة Remove، وقم بتمرير اسم الخاصية المراد إزالتها، أو طريقة RemoveAt لإزالة الخاصية عن طريق الفهرس. يمكنك أيضًا إزالة كافة الخصائص باستخدام طريقة Clear.
يتحقق مثال التعليمات البرمجية التالي من وجود خاصية مخصصة تحمل اسمًا محددًا في المستند ويضيف المزيد من خصائص المستند المخصصة:
يوضح مثال التعليمات البرمجية التالي كيفية إزالة خاصية مستند مخصص:
تحديث خصائص المستند المضمنة
لا يقوم Aspose.Words بتحديث خصائص المستند تلقائيًا، كما يفعل Microsoft Word مع بعض الخصائص، ولكنه يوفر طريقة لتحديث بعض خصائص المستند الإحصائية المضمنة. قم باستدعاء أسلوب UpdateWordCount لإعادة حساب الخصائص التالية وتحديثها:
قم بإنشاء خاصية مخصصة جديدة مرتبطة بالمحتوى
يوفر Aspose.Words طريقة AddLinkToContent لإنشاء خاصية مستند مخصصة جديدة مرتبطة بالمحتوى. تقوم هذه الخاصية بإرجاع كائن الخاصية الذي تم إنشاؤه حديثًا أو إرجاعه فارغًا إذا كان LinkSource غير صالح.
يوضح مثال التعليمات البرمجية التالي كيفية تكوين ارتباط إلى خاصية مخصصة:
الحصول على متغيرات الوثيقة
يمكنك الحصول على مجموعة من متغيرات المستند باستخدام خاصية Variables. أسماء وقيم المتغيرات هي سلاسل.
يوضح مثال التعليمات البرمجية التالي كيفية تعداد متغيرات المستند:
إزالة المعلومات الشخصية من المستند
إذا كنت ترغب في مشاركة مستند Word مع أشخاص آخرين، فقد ترغب في إزالة المعلومات الشخصية مثل اسم المؤلف والشركة. للقيام بذلك، استخدم خاصية RemovePersonalInformation لتعيين علامة تشير إلى أن Microsoft Word سيقوم بإزالة جميع معلومات المستخدم من التعليقات والمراجعات وخصائص المستند عند حفظ المستند.
يوضح مثال التعليمات البرمجية التالي كيفية إزالة المعلومات الشخصية: