ListBox.ObjectCollection.Insert(Int32, Object) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt ein Element am angegebenen Index in das Listenfeld ein.

public:
 virtual void Insert(int index, System::Object ^ item);

public:
 void Insert(int index, System::Object ^ item);

public void Insert (int index, object item);

abstract member Insert : int * obj -> unit
override this.Insert : int * obj -> unit

member this.Insert : int * obj -> unit

Public Sub Insert (index As Integer, item As Object)

Parameter

index

Int32

Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.

item

Object

Ein Objekt, das das einzufügende Element repräsentiert.

Implementiert

Insert(Int32, Object)

Ausnahmen

ArgumentOutOfRangeException

Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListBox.ObjectCollection-Klasse.

ArgumentNullException

item ist null.

Hinweise

Mit dieser Methode können Sie ein Element an einer bestimmten Position innerhalb des ListBoxObjekts einfügen. Wenn die Sorted Eigenschaft des ListBox Objekts auf true festgelegt ist, wird das Element in der richtigen Position in index der sortierten Liste hinzugefügt, unabhängig von den im Parameter angegebenen Werten. Wenn ein Objekt der Auflistung hinzugefügt wird, überprüft die ListBox erste Überprüfung, ob die DisplayMember Eigenschaft der ListControl Klasse den Namen eines Elements aus dem objekt enthält, das beim Abrufen des Elementtexts angegeben ist. Wenn die DisplayMember Eigenschaft kein Element angegeben hat, ruft die ToString Methode des Objekts auf, um den Text abzurufen, ListBox der in der Liste angezeigt werden soll.