ComboBox.ObjectCollection.Add-Methode

Diese Methode unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code bestimmt.

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Function Add ( _
    item As Object _
) As Integer
'Usage
Dim instance As ObjectCollection
Dim item As Object
Dim returnValue As Integer

returnValue = instance.Add(item)

public int Add (
    Object item
)

public:
int Add (
    Object^ item
)

public int Add (
    Object item
)

public function Add (
    item : Object
) : int

Parameter

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

Rückgabewert

Der nullbasierte Index des Elements in der Auflistung.

Ausnahmen

Hinweise

Mit dieser Methode wird dem Kombinationsfeld ein Element hinzugefügt. Wenn die Sorted-Eigenschaft der ComboBox auf true festgelegt ist, wird das Element gemäß der alphabetischen Reihenfolge in die Liste eingefügt. Andernfalls wird das Element am Ende der Liste eingefügt.

Im Kombinationsfeld wird eine grafische Darstellung des Elements angezeigt. Diese Darstellung des Inhalts wird durch die DisplayMember-Eigenschaft angegeben. Wenn die DisplayMember-Eigenschaft NULL (Nothing in Visual Basic) ist, wird die ToString-Methode des Elements aufgerufen, um die im Kombinationsfeld angezeigte Zeichenfolge abzurufen. Andernfalls wird die Eigenschaft des gespeicherten Objekts angezeigt, wie durch die DisplayMember-Eigenschaft angegeben. Eine SystemException tritt auf, wenn für das Speichern des neuen Elements nicht genügend Platz vorhanden ist. Wenn Sie dem Kombinationsfeld eine Gruppe von Elementen hinzufügen möchten, ist die AddRange-Methode am besten geeignet. Wenn Sie dem Kombinationsfeld mit der Add-Methode eine Anzahl von Elementen hinzufügen, verwenden Sie die BeginUpdate-Methode, um das Neuzeichnen während des Hinzufügens zu unterbrechen, und die EndUpdate-Methode, um den Vorgang wieder aufzunehmen. Mit der Insert-Methode können Sie die Position in der Liste angeben, an der ein Element hinzugefügt wird. Wenn der Auflistung ein Objekt hinzugefügt wird, ruft ComboBox die ToString-Methode des Objekts auf, um die in der Liste anzuzeigende Zeichenfolge abzurufen.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ComboBox.ObjectCollection-Klasse
ComboBox.ObjectCollection-Member
System.Windows.Forms-Namespace
IList