ListBox.ObjectCollection.Insert(Int32, Object) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insere um item na caixa de listagem no índice especificado.

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)

Parâmetros

index

Int32

O local do índice de base zero no qual o item é inserido.

item

Object

Um objeto que representa o item a ser inserido.

Implementações

Insert(Int32, Object)

Exceções

ArgumentOutOfRangeException

O parâmetro index é menor que zero ou maior que o valor da propriedade Count da classe ListBox.ObjectCollection.

ArgumentNullException

item é null.

Comentários

Esse método permite que você insira um item em uma posição específica dentro do ListBox. Se a Sorted propriedade do ListBox valor for definida como true, o item será adicionado na posição correta dentro da lista classificada, independentemente dos valores especificados no index parâmetro. Quando um objeto é adicionado à coleção, o ListBox primeiro verifica se a DisplayMember propriedade da ListControl classe tem o nome de um membro do objeto especificado para referência ao obter o texto do item. Se a DisplayMember propriedade não tiver um membro especificado, o ListBox então chamará o ToString método do objeto para obter o texto a ser exibido na lista.