إدارة خصائص الوثيقة
مقدمة
Microsoft يوفر Excel القدرة على إضافة خصائص إلى ملفات جداول البيانات. توفر خصائص المستند هذه معلومات مفيدة وتنقسم إلى فئتين كما هو مفصل أدناه.
- الخصائص المحددة بواسطة النظام (المضمنة): تحتوي الخصائص المضمنة على معلومات عامة حول المستند مثل عنوان المستند واسم المؤلف وإحصائيات المستند وما إلى ذلك.
- الخصائص المحددة من قبل المستخدم (المخصصة): الخصائص المخصصة التي يحددها المستخدم النهائي في شكل زوج من الاسم والقيمة.
كيفية إدارة خصائص المستند باستخدام Microsoft إكسل
Microsoft يتيح لك Excel إدارة خصائص المستند لملفات Excel بطريقة WYSIWYG. يرجى اتباع الخطوات التالية لفتحملكيات الحوار في Excel 2016
- منملف من القائمة، حدد معلومات*.
اختيار قائمة المعلومات |
---|
- انقر فوقملكيات العنوان وحدد “الخصائص المتقدمة”.
النقر فوق تحديد الخصائص المتقدمة |
---|
- إدارة خصائص وثيقة الملف.
حوار الخصائص |
---|
في مربع الحوار “خصائص”، توجد علامات تبويب مختلفة، مثل “عام” و"الملخص" و"الإحصائيات" و"المحتويات" و"الجمارك". تساعد كل علامة تبويب في تكوين أنواع مختلفة من المعلومات المتعلقة بالملف. يتم استخدام علامة التبويب “مخصص” لإدارة الخصائص المخصصة. |
كيفية العمل مع خصائص المستند باستخدام Aspose.Cells
يمكن للمطورين إدارة خصائص المستند ديناميكيًا باستخدام واجهات برمجة التطبيقات Aspose.Cells. تساعد هذه الميزة المطورين على تخزين معلومات مفيدة مع الملف، مثل وقت استلام الملف ومعالجته وختمه بالوقت وما إلى ذلك.
Aspose.Cells for .NET يكتب مباشرة المعلومات حول API ورقم الإصدار في مستندات الإخراج. على سبيل المثال، عند تقديم المستند إلى PDF، تتم تعبئة Aspose.Cells for .NETطلب الحقل بقيمة “Aspose.Cells” وPDF منتج الحقل بالقيمة، على سبيل المثال “Aspose.Cells v17.9”.
يرجى ملاحظة أنه لا يمكنك توجيه Aspose.Cells for .NET لتغيير هذه المعلومات أو إزالتها من المستندات الناتجة.
كيفية الوصول إلى خصائص الوثيقة
تدعم واجهات برمجة التطبيقات Aspose.Cells كلا النوعين من خصائص المستند، المضمنة والمخصصة. Aspose.Cells'دفتر العمل يمثل class ملف Excel، ومثل ملف Excel، فإن ملفدفتر العمل يمكن أن يحتوي الفصل على أوراق عمل متعددة، يتم تمثيل كل منها بواسطة ملفورقة عمل فئة بينما يتم تمثيل مجموعة أوراق العمل بواسطةمجموعة أوراق العملفصل.
استخدم المجموعة أوراق العملللوصول إلى خصائص مستند الملف كما هو موضح أدناه.
- للوصول إلى خصائص المستند المضمنة، استخدمWorksheetCollection.BuiltInDocumentProperties.
- للوصول إلى خصائص المستند المخصصة، استخدمWorksheetCollection.CustomDocumentProperties.
كلا الWorksheetCollection.BuiltInDocumentProperties وWorksheetCollection.CustomDocumentProperties إرجاع مثيلAspose.Cells.Properties.DocumentPropertyCollection. تحتوي هذه المجموعة علىAspose.Cells.Properties.DocumentPropertyكائنات، يمثل كل منها خاصية مستند واحدة مضمنة أو مخصصة.
الأمر متروك لمتطلبات التطبيق حول كيفية الوصول إلى العقار، أي؛ باستخدام الفهرس أو اسم الخاصية منDocumentPropertyCollectionكما هو موضح في المثال أدناه.
الAspose.Cells.Properties.DocumentPropertyتسمح الفئة باسترداد اسم وقيمة ونوع خاصية المستند:
- للحصول على اسم الخاصية، استخدمDocumentProperty.Name.
- للحصول على قيمة العقار استخدمDocumentProperty.Value. DocumentProperty.Valueترجع القيمة ككائن.
- للحصول على نوع الخاصية، استخدمDocumentProperty.Type . يؤدي هذا إلى إرجاع أحدنوع الملكيةقيم التعداد. بعد حصولك على نوع الخاصية، استخدم أحدDocumentProperty.ToXXX طرق للحصول على قيمة النوع المناسب بدلا من استخدامهDocumentProperty.Value . الDocumentProperty.ToXXXتم وصف الطرق في الجدول أدناه.
اسم عضو | وصف | طريقة تو XXX |
---|---|---|
منطقية | نوع بيانات الخاصية هو منطقي | ToBool |
تاريخ | نوع بيانات الخاصية هو DateTime. لاحظ أن Microsoft يخزن Excel فقط جزء التاريخ، لا يمكن تخزين أي وقت في خاصية مخصصة من هذا النوع |
إلىDateTime |
يطفو | نوع بيانات الخاصية مزدوج | للمضاعفة |
رقم | نوع بيانات الخاصية هو Int32 | ToInt |
String | نوع بيانات الخاصية هو سلسلة | إلى سلسلة |
كيفية إضافة أو إزالة خصائص المستند المخصصة
كما وصفنا سابقًا في بداية هذا الموضوع، لا يمكن للمطورين إضافة أو إزالة الخصائص المضمنة لأن هذه الخصائص معرفة من قبل النظام ولكن من الممكن إضافة أو إزالة الخصائص المخصصة لأنها معرفة من قبل المستخدم.
كيفية إضافة خصائص مخصصة
Aspose.Cells كشفت واجهات برمجة التطبيقات (APIs) عنيضيف طريقة لCustomDocumentPropertyCollection class لإضافة خصائص مخصصة إلى المجموعة. اليضيف تضيف الطريقة الخاصية إلى ملف Excel وتقوم بإرجاع مرجع لخاصية المستند الجديد كملفAspose.Cells.Properties.DocumentPropertyهدف.
كيفية تكوين خاصية “الارتباط بالمحتوى” المخصصة
لإنشاء خاصية مخصصة مرتبطة بمحتوى نطاق معين، قم باستدعاءCustomDocumentPropertyCollection.AddLinkToContent طريقة وتمرير اسم الخاصية والمصدر. يمكنك التحقق مما إذا تم تكوين الخاصية على أنها مرتبطة بالمحتوى باستخدامDocumentProperty.IsLinkedToContent ملكية. علاوة على ذلك، من الممكن أيضًا الحصول على نطاق المصدر باستخداممصدر ملكيةDocumentPropertyفصل.
نستخدم قالب Excel بسيطًا Microsoft في المثال. يحتوي المصنف على نطاق مسمى محدد يسمىMyRange والذي يشير إلى قيمة الخلية.
كيفية إزالة الخصائص المخصصة
لإزالة الخصائص المخصصة باستخدام Aspose.Cells، اتصل بالرقمDocumentPropertyCollection.Removeالطريقة وتمرير اسم خاصية المستند المراد إزالتها.