SdtListItemCollection

SdtListItemCollection class

Şuna erişim sağlar:SdtListItem yapılandırılmış bir belge etiketinin öğeleri.

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Yapılandırılmış Belge Etiketleri veya İçerik Denetimi belgeleme makalesi.

public class SdtListItemCollection : IEnumerable<SdtListItem>

Özellikleri

İsimTanım
Count { get; }Koleksiyondaki öğelerin sayısını alır.
Item { get; }BirSdtListItem koleksiyondaki sıfır tabanlı indeksi verilen nesne.
SelectedValue { get; set; }Bu listede şu anda seçili değeri belirtir. Boş değere izin verilir, yani şu anda seçili bir girdi bu liste öğesi koleksiyonuyla ilişkilendirilmemiştir.

yöntemler

İsimTanım
Add(SdtListItem)Bu koleksiyona bir öğe ekler.
Clear()Bu koleksiyondaki tüm öğeleri temizler.
GetEnumerator()Koleksiyondaki tüm öğeler üzerinde yineleme yapmak için kullanılabilen bir numaratör nesnesi döndürür.
RemoveAt(int)Belirtilen dizindeki bir liste öğesini kaldırır.

Örnekler

Açılır liste yapılandırılmış belge etiketleriyle nasıl çalışılacağını gösterir.

Document doc = new Document();
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DropDownList, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(tag);

// Açılır liste yapılandırılmış belge etiketi, kullanıcının
// sol tıklayarak listeden bir seçenek seçin ve formu Microsoft Word'de açın.
// "ListItems" özelliği tüm liste öğelerini içerir ve her liste öğesi bir "SdtListItem"dır.
SdtListItemCollection listItems = tag.ListItems;
listItems.Add(new SdtListItem("Value 1"));

Assert.AreEqual(listItems[0].DisplayText, listItems[0].Value);

// 3 tane daha liste öğesi ekle. Bu öğeleri ilk öğeye göre farklı bir oluşturucu kullanarak başlat
// değerlerinden farklı olan dizeleri görüntülemek için.
listItems.Add(new SdtListItem("Item 2", "Value 2"));
listItems.Add(new SdtListItem("Item 3", "Value 3"));
listItems.Add(new SdtListItem("Item 4", "Value 4"));

Assert.AreEqual(4, listItems.Count);

// Açılır liste ilk öğeyi görüntülüyor. "SelectedValue" öğesini görüntülemek için ona farklı bir liste öğesi atayın.
listItems.SelectedValue = listItems[3];

Assert.AreEqual("Value 4", listItems.SelectedValue.Value);

// Koleksiyon üzerinde numaralandırma yap ve her bir elemanı yazdır.
using (IEnumerator<SdtListItem> enumerator = listItems.GetEnumerator())
{
    while (enumerator.MoveNext())
        if (enumerator.Current != null)
            Console.WriteLine($"List item: {enumerator.Current.DisplayText}, value: {enumerator.Current.Value}");
}

 // Son liste öğesini kaldır.
listItems.RemoveAt(3);

Assert.AreEqual(3, listItems.Count);

// Açılır kontrolümüz varsayılan olarak kaldırılan öğeyi görüntüleyecek şekilde ayarlandığından, mevcut bir öğeyi görüntüleyecek şekilde ayarlayın.
listItems.SelectedValue = listItems[1];

doc.Save(ArtifactsDir + "StructuredDocumentTag.ListItemCollection.docx");

// Tüm açılır öğe koleksiyonunu bir kerede boşaltmak için "Temizle" yöntemini kullanın.
listItems.Clear();

Assert.AreEqual(0, listItems.Count);

Ayrıca bakınız

SdtListItem Class SdtType Enum