ListBox.ObjectCollection.Insert(Int32, Object) Metodo

Definizione

Inserisce un elemento nell'elenco a discesa in corrispondenza dell'indice specificato.Inserts an item into the list box at the specified index.

public:
 void Insert(int index, System::Object ^ item);
public:
 virtual void Insert(int index, System::Object ^ item);
public void Insert (int index, object item);
member this.Insert : int * obj -> unit
abstract member Insert : int * obj -> unit
override 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.The zero-based index location where the item is inserted.

item
Object

Oggetto che rappresenta l'elemento da inserire.An object representing the item to insert.

Implementazioni

Eccezioni

Il parametro index è minore di zero o maggiore del valore della proprietà Count della classe ListBox.ObjectCollection.The index parameter is less than zero or greater than value of the Count property of the ListBox.ObjectCollection class.

item è null.item is null.

Commenti

Questo metodo consente di inserire un elemento in una posizione specifica all'interno di ListBox .This method enables you to insert an item at a specific position within the 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.If the Sorted property of the ListBox is set to true, the item is added in the correct position within the sorted list regardless of the values specified in the index parameter. Quando un oggetto viene aggiunto alla raccolta, ListBox verifica innanzitutto se la DisplayMember proprietà della ListControl classe ha il nome di un membro dell'oggetto specificato a cui fare riferimento quando si ottiene il testo dell'elemento.When an object is added to the collection, the ListBox first checks to see if the DisplayMember property of the ListControl class has the name of a member from the object specified to reference when obtaining the item text. Se la DisplayMember proprietà non dispone di un membro specificato, ListBox chiama il ToString metodo dell'oggetto per ottenere il testo da visualizzare nell'elenco.If the DisplayMember property does not have a member specified, the ListBox then calls the ToString method of the object to obtain the text to display in the list.

Si applica a