ComboBox.ObjectCollection.Add(Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Liste der Elemente für ein Element ein ComboBox.
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 Element darstellt, das der Auflistung hinzugefügt werden soll.
Gibt zurück
Der nullbasierte Index des Elements in der Auflistung.
Ausnahmen
Der item Parameter war null.
Hinweise
Mit dieser Methode wird dem Kombinationsfeld ein Element hinzugefügt. 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 von der 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 Ereignis tritt auf, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist. Um dem Kombinationsfeld eine Reihe 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 BeginUpdate Methode, um die Aktualisierung während des Add-Ins und der Methode zum Fortsetzen der EndUpdate Aktualisierung anzusetzen. Mit der Insert Methode können Sie den Speicherort in der Liste angeben, 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.