إدارة خصائص الوثيقة
مقدمة
يوفر Microsoft Excel إمكانية إضافة خصائص إلى ملفات جداول البيانات. توفر خصائص المستند هذه معلومات مفيدة وهي مقسمة إلى فئتين كما هو مفصل أدناه.
- الخصائص المحددة من قبل النظام (المضمنة): تحتوي الخصائص المضمنة على معلومات عامة حول المستند مثل عنوان المستند واسم المؤلف وإحصائيات المستند وما إلى ذلك.
- الخصائص المعرفة من قبل المستخدم (المخصصة): الخصائص المخصصة التي يحددها المستخدم النهائي في شكل زوج الاسم والقيمة.
إدارة خصائص الوثيقة باستخدام Microsoft Excel
Microsoft يسمح لك Excel بإدارة خصائص الوثيقة لملفات Excel بطريقة WYSIWYG. يرجى اتباع الخطوات التالية لفتح ملفملكيات الحوار في Excel 2016.
- منملف القائمة ، حددمعلومات.
اختيار قائمة المعلومات |
---|
- انقر فوقملكياتالعنوان وحدد “خصائص متقدمة”.
النقر فوق تحديد الخصائص المتقدمة |
---|
- إدارة خصائص وثيقة الملف.
حوار الخصائص |
---|
في مربع حوار الخصائص ، توجد علامات تبويب مختلفة ، مثل عام ، وملخص ، وإحصاءات ، ومحتويات ، وعادات. تساعد كل علامة تبويب في تكوين أنواع مختلفة من المعلومات المتعلقة بالملف. يتم استخدام علامة التبويب “مخصص” لإدارة الخصائص المخصصة. |
التعامل مع خصائص الوثيقة باستخدام Aspose.Cells
يمكن للمطورين إدارة خصائص الوثيقة ديناميكيًا باستخدام Aspose.Cells APIs. تساعد هذه الميزة المطورين على تخزين المعلومات المفيدة مع الملف ، مثل وقت استلام الملف ومعالجته وختمه بالوقت وما إلى ذلك.
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 ، فإن ملفدفتر العمل يمكن أن تحتوي الفئة على أوراق عمل متعددة ، يمثل كل منها ملفورقة عمل class بينما يتم تمثيل مجموعة أوراق العمل بواسطةورقة العملصف دراسي.
استخدم الورقة العملللوصول إلى خصائص مستند الملف كما هو موضح أدناه.
- للوصول إلى خصائص المستند المضمنة ، استخدمWorksheetCollection.BuiltInDocumentProperties.
- للوصول إلى خصائص المستند المخصصة ، استخدمWorksheetCollection.CustomDocumentProperties.
كلا ال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الطريقة وتمرير اسم خاصية المستند المراد إزالتها.