ListBox.ObjectCollection.Insert(Int32, Object) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Inserisce un elemento nell'elenco a discesa in corrispondenza dell'indice specificato.

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)

Parametri

index

Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.

item

Object

Oggetto che rappresenta l'elemento da inserire.

Implementazioni

Insert(Int32, Object)

Eccezioni

ArgumentOutOfRangeException

Il parametro index è minore di zero o maggiore del valore della proprietà Count della classe ListBox.ObjectCollection.

ArgumentNullException

item è null.

Commenti

Questo metodo consente di inserire un elemento in una posizione specifica all'interno di ListBox. Se la Sorted proprietà di ListBox è impostata su true, l'elemento viene aggiunto nella posizione corretta all'interno dell'elenco ordinato indipendentemente dai valori specificati nel index parametro . Quando un oggetto viene aggiunto all'insieme, il ListBox primo verifica se la DisplayMember proprietà della ListControl classe ha il nome di un membro dell'oggetto specificato per fare riferimento quando si ottiene il testo dell'elemento. Se la DisplayMember proprietà non dispone di un membro specificato, chiama ListBox il ToString metodo dell'oggetto per ottenere il testo da visualizzare nell'elenco.