CustomDocumentProperties

CustomDocumentProperties class

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

لمعرفة المزيد، قم بزيارةالعمل مع خصائص الوثيقة مقالة توثيقية.

public class CustomDocumentProperties : DocumentPropertyCollection

الخصائص

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

طُرق

اسموصف
Add(string, bool)إنشاء خاصية مستند مخصصة جديدة لـBoolean نوع البيانات.
Add(string, DateTime)إنشاء خاصية مستند مخصصة جديدة لـDateTime نوع البيانات.
Add(string, double)إنشاء خاصية مستند مخصصة جديدة لـDouble نوع البيانات.
Add(string, int)إنشاء خاصية مستند مخصصة جديدة لـNumber نوع البيانات.
Add(string, string)إنشاء خاصية مستند مخصصة جديدة لـ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}\"");
}

أنظر أيضا