العمل مع خصائص المستند

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

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

من المفيد معرفة أن المعلومات حول API ورقم الإصدار مكتوبة مباشرة إلى مستندات الإخراج. على سبيل المثال، عند تحويل مستند إلى PDF، يملأ Aspose.Words حقل “التطبيق” بـ “Aspose.Words “، وحقل " PDF المنتج “بـ"Aspose.Words ل C++ YY.م. ن “، حيث YY.M.N هي نسخة Aspose.Words المستخدمة للتحويل. لمزيد من التفاصيل، انظر اسم المولد أو المنتج المضمن في مستندات الإخراج.

لاحظ أنك cannot direct Aspose.Words لتغيير أو إزالة هذه المعلومات من مستندات الإخراج.

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

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

• BuiltInDocumentProperties للحصول على خصائص مدمجة.

• CustomDocumentProperties للحصول على خصائص مخصصة.

BuiltInDocumentProperties

BuiltInDocumentProperties

تتيح لك فئة DocumentProperty الحصول على اسم وقيمة ونوع خاصية المستند. Value بإرجاع كائن، ولكن هناك مجموعة من الأساليب مما يسمح لك للحصول على قيمة الخاصية تحويلها إلى نوع معين. بعد التعرف على نوع الخاصية، يمكنك استخدام إحدى طرق DocumentProperty.ToXXX، مثل DocumentProperty.ToString و DocumentProperty.ToInt، للحصول على قيمة النوع المناسب.

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

يمكنك تنزيل ملف القالب لهذا المثال من Aspose.Words GitHub.

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

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

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

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

لإزالة الخصائص المخصصة، استخدم طريقة Remove، مرورا باسم الخاصية المراد إزالتها، أو طريقة RemoveAt لإزالة الخاصية حسب الفهرس. يمكنك أيضا إزالة جميع الخصائص باستخدام طريقة Clear.

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

يمكنك تنزيل ملف القالب لهذا المثال من Aspose.Words GitHub.

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

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

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

• Characters
• CharactersWithSpaces
• Words
• Paragraphs
• Lines

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

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

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

احصل على متغيرات المستند

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

يوضح مثال الكود التالي كيفية تعداد متغيرات المستند:

يمكنك تنزيل ملف القالب لهذا المثال من Aspose.Words GitHub.

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

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

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

لا يؤدي تعيين هذا الخيار فعليا إلى إزالة المعلومات الشخصية أثناء معالجة مستند في Aspose.Words ويؤثر فقط على سلوك Microsoft Word.