DocumentPropertyCollection

DocumentPropertyCollection class

Temel sınıfBuiltInDocumentProperties VeCustomDocumentProperties koleksiyonlar.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Belge Özellikleriyle Çalışma belgeleme makalesi.

public abstract class DocumentPropertyCollection : IEnumerable<DocumentProperty>

Özellikleri

İsimTanım
Count { get; }Koleksiyondaki öğelerin sayısını alır.
Item { get; }BirDocumentProperty nesne index. tarafından
virtual Item { get; }BirDocumentProperty nesnenin özelliğinin adına göre.

yöntemler

İsimTanım
Clear()Koleksiyondan tüm özellikleri kaldırır.
Contains(string)Geri Döndürürdoğru belirtilen ada sahip bir özellik koleksiyonda mevcutsa.
GetEnumerator()Koleksiyondaki tüm öğeler üzerinde yineleme yapmak için kullanılabilen bir numaratör nesnesi döndürür.
IndexOf(string)Bir özelliğin adına göre dizinini 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 mülkler adlarına 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.
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" -> "Özellikler" > "Gelişmiş Özellikler" > "Özel" yoluyla bulabiliriz.
doc.Save(ArtifactsDir + "DocumentProperties.DocumentPropertyCollection.docx");

// Aşağıda bir belgeden özel özellikleri kaldırmanın üç yolu bulunmaktadır.
// 1 - Dizinle 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 - Tüm koleksiyonu bir defada boşalt:
properties.Clear();

Assert.AreEqual(0, properties.Count);

Ayrıca bakınız

DocumentProperty Class DocumentSecurity Enum