ComboBox.ObjectCollection.Add(Object) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fügt der Liste von Elementen für eine ComboBox ein Element hinzu.

public:
 int Add(System::Object ^ item);
public int Add (object item);
member this.Add : obj -> int
Public Function Add (item As Object) As Integer

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.

Ausnahmen

ArgumentNullException

Der item-Parameter war null.

Hinweise

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

Im Kombinationsfeld wird eine visuelle Darstellung des Elements angezeigt. Diese Inhaltsdarstellung wird durch die DisplayMember -Eigenschaft angegeben. Wenn die DisplayMember -Eigenschaft lautet null, wird die Methode des ToString Elements aufgerufen, um die Zeichenfolge abzurufen, die im Kombinationsfeld angezeigt wird. Andernfalls wird die Eigenschaft des gespeicherten Objekts angezeigt, wie durch die DisplayMember -Eigenschaft angegeben. Ein SystemException tritt auf, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist. Um dem Kombinationsfeld einen Satz von Elementen hinzuzufügen, empfiehlt es sich, die AddRange -Methode zu verwenden. Wenn Sie die Add -Methode verwenden, um dem Kombinationsfeld eine Reihe von Elementen hinzuzufügen, verwenden Sie die -Methode, um die BeginUpdate Neulackierung während des Add-Vorgangs anzusetzen und die -Methode, um die EndUpdate Neulackierung fortzusetzen. 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 ToString -Objekts auf, um die Zeichenfolge abzurufen, die in der Liste angezeigt werden soll.

Gilt für:

Weitere Informationen