ListBox.ObjectCollection.Insert(Int32, Object) Method

Definition

Insere um item na caixa de listagem no índice especificado.Inserts an item into the list box at the specified index.

public:
 virtual 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
Public Sub Insert (index As Integer, item As Object)

Parameters

index
Int32

O local do índice de base zero no qual o item é inserido.The zero-based index location where the item is inserted.

item
Object

Um objeto que representa o item a ser inserido.An object representing the item to insert.

Implements

Exceptions

O parâmetro index é menor que zero ou maior que o valor da propriedade Count da 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.

Remarks

Esse método permite que você insira um item em uma posição específica dentro do ListBox.This method enables you to insert an item at a specific position within the ListBox. Se a propriedade Sorted da ListBox for definida como true, o item será adicionado na posição correta dentro da lista classificada, independentemente dos valores especificados no parâmetro index.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 um objeto é adicionado à coleção, o ListBox primeiro verifica se a propriedade DisplayMember da classe ListControl tem o nome de um membro do objeto especificado como referência ao obter o texto do item.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 a propriedade DisplayMember não tiver um membro especificado, a ListBox chamará o método ToString do objeto para obter o texto a ser exibido na lista.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.

Applies to