إدارة خصائص الوثيقة

مقدمة

يوفر Microsoft Excel إمكانية إضافة خصائص إلى ملفات جداول البيانات. توفر خصائص المستند هذه معلومات مفيدة وهي مقسمة إلى فئتين كما هو مفصل أدناه.

  • الخصائص المحددة من قبل النظام (المضمنة): تحتوي الخصائص المضمنة على معلومات عامة حول المستند مثل عنوان المستند واسم المؤلف وإحصائيات المستند وما إلى ذلك.
  • الخصائص المعرفة من قبل المستخدم (المخصصة): الخصائص المخصصة التي يحددها المستخدم النهائي في شكل زوج الاسم والقيمة.

إدارة خصائص الوثيقة باستخدام Microsoft Excel

Microsoft يسمح لك Excel بإدارة خصائص الوثيقة لملفات Excel بطريقة WYSIWYG. يرجى اتباع الخطوات التالية لفتح ملفملكيات الحوار في Excel 2016.

  1. منملف القائمة ، حددمعلومات.
اختيار قائمة المعلومات
ما يجب القيام به: image_بديل_نص
  1. انقر فوقملكياتالعنوان وحدد “خصائص متقدمة”.
النقر فوق تحديد الخصائص المتقدمة
ما يجب القيام به: image_بديل_نص
  1. إدارة خصائص وثيقة الملف.
حوار الخصائص
ما يجب القيام به: image_بديل_نص
في مربع حوار الخصائص ، توجد علامات تبويب مختلفة ، مثل عام ، وملخص ، وإحصاءات ، ومحتويات ، وعادات. تساعد كل علامة تبويب في تكوين أنواع مختلفة من المعلومات المتعلقة بالملف. يتم استخدام علامة التبويب “مخصص” لإدارة الخصائص المخصصة.

التعامل مع خصائص الوثيقة باستخدام Aspose.Cells

يمكن للمطورين إدارة خصائص الوثيقة ديناميكيًا باستخدام Aspose.Cells APIs. تساعد هذه الميزة المطورين على تخزين المعلومات المفيدة مع الملف ، مثل وقت استلام الملف ومعالجته وختمه بالوقت وما إلى ذلك.

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

تدعم واجهات برمجة التطبيقات Aspose.Cells كلا نوعي خصائص المستند المضمنة والمخصصة. Aspose.Cells ‘دفتر العمل يمثل class ملف Excel ، ومثل ملف Excel ، فإن ملفدفتر العمل يمكن أن تحتوي الفئة على أوراق عمل متعددة ، يمثل كل منها ملفورقة عمل class بينما يتم تمثيل مجموعة أوراق العمل بواسطةورقة العملصف دراسي.

استخدم الورقة العملللوصول إلى خصائص مستند الملف كما هو موضح أدناه.

كلا الWorksheetCollection.BuiltInDocumentProperties وWorksheetCollection.CustomDocumentProperties إرجاع مثيلAspose.Cells.Properties.DocumentPropertyCollection. هذه المجموعة تحتوي علىAspose.Cells.Properties.DocumentPropertyكائنات ، يمثل كل منها خاصية واحدة مضمنة أو مخصصة للمستند.

الأمر متروك لمتطلبات التطبيق في كيفية الوصول إلى الممتلكات ، أي ؛ باستخدام فهرس أو اسم الخاصية منDocumentPropertyCollectionكما هو موضح في المثال أدناه.

الAspose.Cells.Properties.DocumentPropertyتسمح class باسترداد اسم وقيمة ونوع خاصية المستند:

  • للحصول على اسم الخاصية ، استخدمDocumentProperty.Name.
  • للحصول على قيمة العقار ، استخدمالوثيقة القيمة. الوثيقة القيمةتُرجع القيمة ككائن.
  • للحصول على نوع الخاصية ، استخدمDocumentProperty.Type . هذا يعيد واحد مننوع الملكية قيم التعداد. بعد الحصول على نوع الخاصية ، استخدم أحد ملفاتالوثيقة الملكية. إلى XXX طرق للحصول على قيمة النوع المناسب بدلاً من استخدامالوثيقة القيمة . الالوثيقة الملكية. إلى XXXالطرق موضحة في الجدول أدناه.
اسم عضو وصف طريقة ToXXX
قيمة منطقية نوع بيانات الخاصية منطقي ToBool
تاريخ نوع بيانات الخاصية هو DateTime. لاحظ أن Microsoft يخزن Excel فقط
جزء التاريخ ، لا يمكن تخزين أي وقت في خاصية مخصصة من هذا النوع
ToDateTime
تطفو نوع بيانات الخاصية هو مزدوج للمضاعفة
عدد نوع بيانات الخاصية هو Int32 ToInt
سلسلة نوع بيانات الخاصية هو String إلى سلسلة

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

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

إضافة خصائص مخصصة

كشفت واجهات برمجة التطبيقات Aspose.Cells ملفيضيف طريقة لCustomDocumentPropertyCollection class لإضافة خصائص مخصصة إلى المجموعة. اليضيف أسلوب إضافة الخاصية إلى ملف Excel وإرجاع مرجع لخاصية المستند الجديدة كملفAspose.Cells.Properties.DocumentPropertyموضوع.

تكوين خاصية مخصصة “ارتباط بالمحتوى”

لإنشاء خاصية مخصصة مرتبطة بمحتوى نطاق معين ، قم باستدعاءCustomDocumentPropertyCollection.AddLinkToContent طريقة واسم الملكية والمصدر. يمكنك التحقق مما إذا كانت الخاصية قد تم تكوينها على أنها مرتبطة بالمحتوى باستخدامDocumentProperty.SLinkedToContent خاصية. علاوة على ذلك ، من الممكن أيضًا الحصول على نطاق المصدر باستخداممصدر ممتلكاتوثيقة الملكيةصف دراسي.

نستخدم ملف إكسل Microsoft قالب بسيط في المثال. يحتوي المصنف على نطاق مسمى محدد يسمىMyRange الذي يشير إلى قيمة الخلية.

إزالة الخصائص المخصصة

لإزالة الخصائص المهيأة باستخدام Aspose.Cells ، قم باستدعاءDocumentPropertyCollection.Removeالطريقة وتمرير اسم خاصية المستند المراد إزالتها.

موضوعات مسبقة