العمل مع خصائص الوثيقة

تسمح خصائص المستند بتخزين بعض المعلومات المفيدة حول مستندك. ويمكن تقسيم هذه الخصائص إلى مجموعتين:

  • النظام أو المدمج الذي يحتوي على قيم مثل عنوان المستند واسم المؤلف وإحصائيات المستند وغيرها.
  • معرف من قبل المستخدم أو مخصص، يتم توفيره كأزواج اسم وقيمة حيث يمكن للمستخدم تحديد كل من الاسم والقيمة.

من المفيد معرفة أن المعلومات المتعلقة بـ API ورقم الإصدار تتم كتابتها مباشرة لإخراج المستندات. على سبيل المثال، عند تحويل مستند إلى PDF، يقوم Aspose.Words بملء حقل “Application” بـ “Aspose.Words”، وحقل “PDF Producer” بـ “Aspose.Words for .NET YY.MN”، حيث يكون YY.M.N هو إصدار Aspose.Words المستخدم للتحويل. لمزيد من التفاصيل، راجع اسم المولد أو المنتج مدرج في مستندات الإخراج.

الوصول إلى خصائص المستند

للوصول إلى خصائص المستند في Aspose.Words، استخدم:

built_in_document_properties وcustom_document_properties عبارة عن مجموعات من كائنات DocumentProperty. يمكن الحصول على هذه الكائنات من خلال خاصية المفهرس بالاسم أو بالفهرس.

يوفر built_in_document_properties أيضًا إمكانية الوصول إلى خصائص المستند من خلال مجموعة من الخصائص المدخلة التي تُرجع قيمًا من النوع المناسب. يمكّنك custom_document_properties من إضافة أو إزالة خصائص المستند من المستند.

تتيح لك فئة DocumentProperty الحصول على اسم وقيمة ونوع خاصية المستند. تقوم value بإرجاع كائن، ولكن هناك مجموعة من الأساليب التي تسمح لك بتحويل قيمة الخاصية إلى نوع معين. بعد أن تتعرف على نوع الخاصية، يمكنك استخدام إحدى طرق DocumentProperty.to_XXX، مثل DocumentProperty.__str__ وDocumentProperty.to_int، للحصول على قيمة النوع المناسب.

يوضح مثال التعليمات البرمجية التالي كيفية تعداد كافة الخصائص المضمنة والمخصصة في مستند:

في Microsoft Word، يمكنك الوصول إلى خصائص المستند باستخدام القائمة “ملف → خصائص”.

العمل مع خصائص المستند 1.png

إضافة أو إزالة خصائص المستند

لا يمكنك إضافة أو إزالة خصائص المستند المضمنة باستخدام Aspose.Words. يمكنك فقط تغيير أو تحديث قيمها.

لإضافة خصائص مستند مخصصة باستخدام Aspose.Words، استخدم طريقة add، وقم بتمرير اسم الخاصية الجديد وقيمة النوع المناسب. تقوم الطريقة بإرجاع كائن DocumentProperty المنشأ حديثًا.

لإزالة الخصائص المخصصة، استخدم طريقة remove، وقم بتمرير اسم الخاصية المراد إزالتها، أو طريقة remove_at لإزالة الخاصية عن طريق الفهرس. يمكنك أيضًا إزالة كافة الخصائص باستخدام طريقة clear.

يتحقق مثال التعليمات البرمجية التالي من وجود خاصية مخصصة تحمل اسمًا محددًا في المستند ويضيف المزيد من خصائص المستند المخصصة:

يوضح مثال التعليمات البرمجية التالي كيفية إزالة خاصية مستند مخصص:

تحديث خصائص المستند المضمنة

لا يقوم Aspose.Words بتحديث خصائص المستند تلقائيًا، كما يفعل Microsoft Word مع بعض الخصائص، ولكنه يوفر طريقة لتحديث بعض خصائص المستند الإحصائية المضمنة. قم باستدعاء أسلوب update_word_count لإعادة حساب الخصائص التالية وتحديثها:

قم بإنشاء خاصية مخصصة جديدة مرتبطة بالمحتوى

يوفر Aspose.Words طريقة add_link_to_content لإنشاء خاصية مستند مخصصة جديدة مرتبطة بالمحتوى. تقوم هذه الخاصية بإرجاع كائن الخاصية الذي تم إنشاؤه حديثًا أو إرجاعه فارغًا إذا كان link_source غير صالح.

يوضح مثال التعليمات البرمجية التالي كيفية تكوين ارتباط إلى خاصية مخصصة:

الحصول على متغيرات الوثيقة

يمكنك الحصول على مجموعة من متغيرات المستند باستخدام خاصية variables. أسماء وقيم المتغيرات هي سلاسل.

يوضح مثال التعليمات البرمجية التالي كيفية إضافة متغيرات المستند والوصول إليها:

إزالة المعلومات الشخصية من المستند

إذا كنت ترغب في مشاركة مستند Word مع أشخاص آخرين، فقد ترغب في إزالة المعلومات الشخصية مثل اسم المؤلف والشركة. للقيام بذلك، استخدم خاصية remove_personal_information لتعيين علامة تشير إلى أن Microsoft Word سيقوم بإزالة جميع معلومات المستخدم من التعليقات والمراجعات وخصائص المستند عند حفظ المستند.

يوضح مثال التعليمات البرمجية التالي كيفية إزالة المعلومات الشخصية:

التحويل بين وحدات القياس