DocumentPropertyCollection

DocumentPropertyCollection class

Temel sınıfBuiltInDocumentProperties VeCustomDocumentProperties koleksiyonlar.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Belge Özellikleriyle Çalışma dokümantasyon makalesi.

public abstract class DocumentPropertyCollection : IEnumerable<DocumentProperty>

Özellikleri

İsimTanım
Count { get; }Koleksiyondaki öğelerin sayısını alır.
Item { get; }Bir değeri döndürürDocumentProperty indekse göre nesne.
virtual Item { get; }Bir değeri döndürürDocumentProperty özelliğin adına göre nesne.

yöntemler

İsimTanım
Clear()Koleksiyondaki tüm özellikleri kaldırır.
Contains(string)İadelerdoğru koleksiyonda belirtilen ada sahip bir özellik mevcutsa.
GetEnumerator()Koleksiyondaki tüm öğeler üzerinde yineleme yapmak için kullanılabilecek bir numaralandırıcı nesnesini döndürür.
IndexOf(string)Bir özelliğin dizinini ada göre alır.
Remove(string)Belirtilen ada sahip bir özelliği koleksiyondan kaldırır.
RemoveAt(int)Belirtilen dizindeki bir özelliği kaldırır.

Notlar

Özelliklerin adları büyük/küçük harfe duyarlı değildir.

Koleksiyondaki özellikler ada göre alfabetik olarak sıralanmıştır.

Örnekler

Bir belgenin özel özellikleriyle nasıl çalışılacağını gösterir.

Document doc = new Document();
CustomDocumentProperties properties = doc.CustomDocumentProperties;

Assert.AreEqual(0, properties.Count);

// Özel belge özellikleri, belgeye ekleyebileceğimiz anahtar-değer çiftleridir.
properties.Add("Authorized", true);
properties.Add("Authorized By", "John Doe");
properties.Add("Authorized Date", DateTime.Today);
properties.Add("Authorized Revision", doc.BuiltInDocumentProperties.RevisionNumber);
properties.Add("Authorized Amount", 123.45);

// Koleksiyon, özel özellikleri alfabetik sıraya göre sıralar.
Assert.AreEqual(1, properties.IndexOf("Authorized Amount"));
Assert.AreEqual(5, properties.Count);

// Belgedeki her özel özelliği yazdırın.
using (IEnumerator<DocumentProperty> enumerator = properties.GetEnumerator())
{
    while (enumerator.MoveNext())
        Console.WriteLine($"Name: \"{enumerator.Current.Name}\"\n\tType: \"{enumerator.Current.Type}\"\n\tValue: \"{enumerator.Current.Value}\"");
}

// DOCPROPERTY alanını kullanarak özel bir özelliğin değerini görüntüleyin.
DocumentBuilder builder = new DocumentBuilder(doc);
FieldDocProperty field = (FieldDocProperty)builder.InsertField(" DOCPROPERTY \"Authorized By\"");
field.Update();

Assert.AreEqual("John Doe", field.Result);

// Bu özel özellikleri Microsoft Word'de "Dosya" -> aracılığıyla bulabiliriz. "Özellikler" > "Gelişmiş Özellikler" > "Gelenek".
doc.Save(ArtifactsDir + "DocumentProperties.DocumentPropertyCollection.docx");

// Aşağıda bir belgeden özel özellikleri kaldırmanın üç yolu bulunmaktadır.
// 1 - Dizine göre kaldır:
properties.RemoveAt(1);

Assert.False(properties.Contains("Authorized Amount"));
Assert.AreEqual(4, properties.Count);

// 2 - İsme göre kaldır:
properties.Remove("Authorized Revision");

Assert.False(properties.Contains("Authorized Revision"));
Assert.AreEqual(3, properties.Count);

// 3 - Koleksiyonun tamamını bir kerede boşaltın:
properties.Clear();

Assert.AreEqual(0, properties.Count);

Ayrıca bakınız