CustomDocumentProperties

CustomDocumentProperties class

مجموعة من خصائص المستند المخصصة.

public class CustomDocumentProperties : DocumentPropertyCollection

الخصائص

اسم وصف
Count { get; } الحصول على عدد العناصر في المجموعة.
Item { get; } إرجاع أDocumentProperty كائن بالفهرس .
virtual Item { get; } إرجاع أDocumentProperty الكائن باسم الخاصية .

طُرق

اسم وصف
Add(string, bool) إنشاء خاصية مستند مخصصة جديدة لملف نوع الملكية. منطقي نوع البيانات .
Add(string, DateTime) إنشاء خاصية مستند مخصصة جديدة لملف PropertyType.DateTime نوع البيانات .
Add(string, double) إنشاء خاصية مستند مخصصة جديدة لملف نوع الملكية نوع البيانات .
Add(string, int) إنشاء خاصية مستند مخصصة جديدة لملف نوع الملكية نوع البيانات .
Add(string, string) إنشاء خاصية مستند مخصصة جديدة لملف PropertyType.String نوع البيانات .
AddLinkToContent(string, string) إنشاء ارتباط جديد بخاصية مستند مخصص للمحتوى.
Clear() يزيل كل الخصائص من المجموعة.
Contains(string) إرجاع صحيح في حالة وجود خاصية بالاسم المحدد في المجموعة.
GetEnumerator() إرجاع كائن العداد الذي يمكن استخدامه للتكرار على كافة العناصر في المجموعة.
IndexOf(string) الحصول على فهرس الخاصية بالاسم .
Remove(string) يزيل خاصية بالاسم المحدد من المجموعة.
RemoveAt(int) يزيل خاصية في الفهرس المحدد .

ملاحظات

كلDocumentProperty يمثل الكائن خاصية مخصصة لمستند حاوية.

أسماء الخصائص غير حساسة لحالة الأحرف.

يتم فرز الخصائص في المجموعة أبجديًا حسب الاسم.

أمثلة

يوضح كيفية التعامل مع خصائص المستند المخصصة.

Document doc = new Document(MyDir + "Properties.docx");

// يحتوي كل مستند على مجموعة من الخصائص المخصصة ، والتي ، مثل الخصائص المضمنة ، هي أزواج مفتاح - قيمة.
// يحتوي المستند على قائمة ثابتة من الخصائص المضمنة. يقوم المستخدم بإنشاء كافة الخصائص المخصصة. 
Assert.AreEqual("Value of custom document property", doc.CustomDocumentProperties["CustomProperty"].ToString());

doc.CustomDocumentProperties.Add("CustomProperty2", "Value of custom document property #2");

Console.WriteLine("Custom Properties:");
foreach (var customDocumentProperty in doc.CustomDocumentProperties)
{
    Console.WriteLine(customDocumentProperty.Name);
    Console.WriteLine($"\tType:\t{customDocumentProperty.Type}");
    Console.WriteLine($"\tValue:\t\"{customDocumentProperty.Value}\"");
}

أنظر أيضا