إدارة خصائص الوثيقة
مقدمة
يوفر Microsoft Excel إمكانية إضافة خصائص إلى ملفات جداول البيانات. توفر خصائص المستند هذه معلومات مفيدة وهي مقسمة إلى فئتين كما هو مفصل أدناه.
- الخصائص المحددة من قبل النظام (المضمنة): تحتوي الخصائص المضمنة على معلومات عامة حول المستند مثل عنوان المستند واسم المؤلف وإحصائيات المستند وما إلى ذلك.
- الخصائص المعرفة من قبل المستخدم (المخصصة): الخصائص المخصصة التي يحددها المستخدم النهائي في شكل زوج الاسم والقيمة.
إدارة خصائص الوثيقة باستخدام Microsoft Excel
Microsoft يسمح Excel بإدارة خصائص المستندات لملفات Excel بطريقة WYSIWYG. يرجى اتباع الخطوات التالية لفتح ملفملكيات الحوار في Excel 2016.
- منملف القائمة ، حددمعلومات.
اختيار قائمة المعلومات |
---|
- انقر فوقملكياتالعنوان وحدد “خصائص متقدمة”.
النقر فوق تحديد الخصائص المتقدمة |
---|
- إدارة خصائص وثيقة الملف.
حوار الخصائص |
---|
في مربع حوار الخصائص ، توجد علامات تبويب مختلفة ، مثل عام ، وملخص ، وإحصاءات ، ومحتويات ، وعادات. تساعد كل علامة تبويب في تكوين أنواع مختلفة من المعلومات المتعلقة بالملف. يتم استخدام علامة التبويب “مخصص” لإدارة الخصائص المخصصة. |
التعامل مع خصائص الوثيقة باستخدام Aspose.Cells
يمكن للمطورين إدارة خصائص الوثيقة ديناميكيًا باستخدام Aspose.Cells APIs. تساعد هذه الميزة المطورين على تخزين المعلومات المفيدة مع الملف ، مثل وقت استلام الملف ومعالجته وختمه بالوقت وما إلى ذلك.
Aspose.Cells for Java يكتب مباشرة المعلومات حول API ورقم الإصدار في وثائق المخرجات. على سبيل المثال ، عند تقديم المستند إلى PDF ، يتم تعبئة Aspose.Cells for Javaتطبيق حقل بقيمة “Aspose.Cells” وPDF منتج الحقل بالقيمة ، على سبيل المثال “Aspose.Cells for Java v17.9”.
يرجى ملاحظة أنه لا يمكنك توجيه Aspose.Cells for Java لتغيير أو إزالة هذه المعلومات من مستندات الإخراج.
الوصول إلى خصائص المستند
تدعم واجهات برمجة التطبيقات Aspose.Cells كلا نوعي خصائص المستند المضمنة والمخصصة. Aspose.Cells ‘دفتر العمل يمثل class ملف Excel ، ومثل ملف Excel ، فإن ملفدفتر العمل يمكن أن تحتوي الفئة على أوراق عمل متعددة ، يمثل كل منها ملفورقة عمل class بينما يتم تمثيل مجموعة أوراق العمل بواسطةورقة العملصف دراسي.
استخدم الورقة العملللوصول إلى خصائص مستند الملف كما هو موضح أدناه.
- للوصول إلى خصائص المستند المضمنة ، استخدمWorksheetCollection.BuiltInDocumentProperties.
- للوصول إلى خصائص المستند المخصصة ، استخدم ملحقWorksheetCollection.CustomDocumentProperties.
كلا الWorksheetCollection.BuiltInDocumentProperties وWorksheetCollection.CustomDocumentProperties إرجاع مثيلDocumentPropertyCollection . هذه المجموعة تحتوي علىوثيقة الملكيةكائنات ، يمثل كل منها خاصية واحدة مضمنة أو مخصصة للمستند.
الأمر متروك لمتطلبات التطبيق في كيفية الوصول إلى الممتلكات ، أي ؛ باستخدام فهرس أو اسم الخاصية منDocumentPropertyCollectionكما هو موضح في المثال أدناه.
الوثيقة الملكيةتسمح class باسترداد اسم وقيمة ونوع خاصية المستند:
- للحصول على اسم الخاصية ، استخدمDocumentProperty.Name.
- للحصول على قيمة العقار ، استخدمالوثيقة القيمة. الوثيقة القيمةتُرجع القيمة ككائن.
- للحصول على نوع الخاصية ، استخدمDocumentProperty.Type . هذا يعيد واحد مننوع الملكيةقيم التعداد.
إضافة أو إزالة خصائص المستند المخصصة
كما أوضحنا سابقًا في بداية هذا الموضوع ، لا يمكن للمطورين إضافة أو إزالة الخصائص المضمنة لأن هذه الخصائص محددة من قبل النظام ولكن من الممكن إضافة أو إزالة الخصائص المخصصة لأنها محددة من قبل المستخدم.
إضافة خصائص مخصصة
كشفت واجهات برمجة التطبيقات Aspose.Cells ملفيضيف طريقة لـCustomDocumentPropertyCollection class لإضافة خصائص مخصصة إلى المجموعة. اليضيف يضيف الأسلوب الخاصية إلى ملف Excel ويعيد مرجعًا لخاصية المستند الجديدة كملفوثيقة الملكيةموضوع.
تكوين خاصية مخصصة “ارتباط بالمحتوى”
لإنشاء خاصية مخصصة مرتبطة بمحتوى نطاق معين ، قم باستدعاءCustomDocumentPropertyCollection.addLinkToContent طريقة واسم خاصية المرور والمصدر. يمكنك التحقق مما إذا كانت الخاصية قد تم تكوينها على أنها مرتبطة بالمحتوى باستخدامDocumentProperty.isLinkedToContent خاصية. علاوة على ذلك ، من الممكن أيضًا الحصول على نطاق المصدر باستخداممصدر ممتلكاتوثيقة الملكيةصف دراسي.
نستخدم ملف إكسل Microsoft قالب بسيط في المثال. يحتوي المصنف على نطاق مسمى محدد يسمىMyRange الذي يشير إلى قيمة الخلية.
إزالة الخصائص المخصصة
لإزالة الخصائص المهيأة باستخدام Aspose.Cells ، قم باستدعاءDocumentPropertyCollection.remove وتمرير اسم خاصية المستند المراد إزالتها.