Add

DropDownItemCollection.Add method

Fügt am Ende der Sammlung eine Zeichenfolge hinzu.

public int Add(string value)

Parameter	Typ	Beschreibung
value	String	Die Zeichenfolge, die am Ende der Sammlung hinzugefügt werden soll.

Rückgabewert

Der nullbasierte Index, an dem das neue Element eingefügt wird.

Beispiele

Zeigt, wie man ein Kombinationsfeldfeld einfügt und die Elemente in seiner Elementsammlung bearbeitet.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Ein Kombinationsfeld einfügen und dann seine Sammlung von Dropdown-Elementen überprüfen.
// In Microsoft Word klickt der Benutzer auf das Kombinationsfeld,
// und wählen Sie dann eines der anzuzeigenden Textelemente in der Sammlung aus.
string[] items = { "One", "Two", "Three" };
FormField comboBoxField = builder.InsertComboBox("DropDown", items, 0);
DropDownItemCollection dropDownItems = comboBoxField.DropDownItems;

Assert.AreEqual(3, dropDownItems.Count);
Assert.AreEqual("One", dropDownItems[0]);
Assert.AreEqual(1, dropDownItems.IndexOf("Two"));
Assert.IsTrue(dropDownItems.Contains("Three"));

// Es gibt zwei Möglichkeiten, ein neues Element zu einer vorhandenen Sammlung von Dropdown-Box-Elementen hinzuzufügen.
// 1 – Ein Element an das Ende der Sammlung anhängen:
dropDownItems.Add("Four");

// 2 – Ein Element vor einem anderen Element an einem angegebenen Index einfügen:
dropDownItems.Insert(3, "Three and a half");

Assert.AreEqual(5, dropDownItems.Count);

// Durch die Sammlung iterieren und jedes Element ausgeben.
using (IEnumerator<string> dropDownCollectionEnumerator = dropDownItems.GetEnumerator())
    while (dropDownCollectionEnumerator.MoveNext())
        Console.WriteLine(dropDownCollectionEnumerator.Current);

// Es gibt zwei Möglichkeiten, Elemente aus einer Sammlung von Dropdown-Elementen zu entfernen.
// 1 – Ein Element entfernen, dessen Inhalt der übergebenen Zeichenfolge entspricht:
dropDownItems.Remove("Four");

// 2 – Ein Element an einem Index entfernen:
dropDownItems.RemoveAt(3);

Assert.AreEqual(3, dropDownItems.Count);
Assert.IsFalse(dropDownItems.Contains("Three and a half"));
Assert.IsFalse(dropDownItems.Contains("Four"));

doc.Save(ArtifactsDir + "FormFields.DropDownItemCollection.html");

// Leeren Sie die gesamte Sammlung von Dropdown-Elementen.
dropDownItems.Clear();

Siehe auch

DropDownItemCollection.Item DropDownItemCollection.Clear