ComboBox.ObjectCollection.IList.Add(Object) Methode

Definition

Eine Beschreibung dieses Elements finden Sie unter Add(Object).

 virtual int System.Collections.IList.Add(System::Object ^ item) = System::Collections::IList::Add;
int IList.Add (object item);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (item As Object) As Integer Implements IList.Add

Parameter

item
Object

Ein Objekt, das das der Auflistung hinzuzufügende Element darstellt.

Gibt zurück

Int32

Der nullbasierte Index des Elements in der Auflistung.

Implementiert

Ausnahmen

Der item-Parameter ist null.

Es ist nicht genügend Speicherplatz verfügbar, um das neue Element zu speichern.

Hinweise

Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn die ComboBox.ObjectCollection-Instanz in eine IList-Schnittstelle umgewandelt wird.

Diese Methode fügt dem Kombinationsfeld ein Element hinzu. Wenn die Sorted Eigenschaft des ComboBox Elements auf true"festgelegt" festgelegt ist, wird das Element alphabetisch in die Liste eingefügt. Andernfalls wird das Element am Ende der Liste eingefügt.

Eine visuelle Darstellung des Elements wird im Kombinationsfeld angezeigt. Diese Inhaltsdarstellung wird durch die DisplayMember Eigenschaft angegeben. Wenn die Eigenschaft lautetnull, wird die DisplayMember Methode des Elements ToString aufgerufen, um die Zeichenfolge abzurufen, die im Kombinationsfeld angezeigt wird. Andernfalls wird die Eigenschaft des gespeicherten Objekts wie durch die DisplayMember Eigenschaft angegeben angezeigt. Um dem Kombinationsfeld eine Gruppe von Elementen hinzuzufügen, empfiehlt es sich, die AddRange Methode zu verwenden. Wenn Sie die Add Methode verwenden möchten, um dem Kombinationsfeld eine Reihe von Elementen hinzuzufügen, verwenden Sie die Methode, um die BeginUpdate Aktualisierung während des Adds und der Methode zum Fortsetzen der EndUpdate Neuaufnahme anzusetzen. Sie können die Insert Methode verwenden, um den Speicherort in der Liste anzugeben, an dem ein Element hinzugefügt wird. Wenn der Auflistung ein Objekt hinzugefügt wird, ruft die ComboBox Methode des Objekts ToString auf, um die Zeichenfolge abzurufen, die in der Liste angezeigt werden soll.

Gilt für

Siehe auch