ListBox.ObjectCollection.Insert(Int32, Object) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wstawia element do pola listy w określonym indeksie.

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)

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

item

Object

Obiekt reprezentujący element do wstawienia.

Implementuje

Insert(Int32, Object)

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż zero lub większy niż wartość Count właściwości ListBox.ObjectCollection klasy.

ArgumentNullException

item to null.

Uwagi

Ta metoda umożliwia wstawianie elementu w określonej pozycji w obiekcie ListBox. Sorted Jeśli właściwość ListBox jest ustawiona na true, element jest dodawany w prawidłowej pozycji na posortowanej liście niezależnie od wartości określonych w parametrze index . Po dodaniu obiektu do kolekcji pierwszy sprawdza, ListBox czy DisplayMember właściwość ListControl klasy ma nazwę elementu członkowskiego z obiektu określonego do odwołania podczas uzyskiwania tekstu elementu. DisplayMember Jeśli właściwość nie ma określonego elementu członkowskiego, ListBox metoda obiektu wywołuje ToString metodę obiektu w celu uzyskania tekstu do wyświetlenia na liście.