ComboBox.ObjectCollection.IList.Add(Object) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Para obter uma descrição desse membro, confira Add(Object).

 virtual int System.Collections.IList.Add(System::Object ^ item) = System::Collections::IList::Add;

int IList.Add (object item);

abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int

Function Add (item As Object) As Integer Implements IList.Add

Parâmetros

item

Object

Um objeto que representa o item a ser adicionado à coleção.

Retornos

Int32

O índice de base zero do item na coleção.

Implementações

Add(Object)

Exceções

ArgumentNullException

O parâmetro item é null.

SystemException

Não há espaço suficiente disponível para armazenar o novo item.

Comentários

Este membro é uma implementação do membro de interface explícita. Ele só pode ser usado quando a instância de ComboBox.ObjectCollection é convertida em uma interface de IList.

Esse método adiciona um item à caixa de combinação. Se a Sorted propriedade do ComboBox é definida como true, o item é inserido na lista em ordem alfabética. Caso contrário, o item será inserido no final da lista.

Uma representação visual do item é exibida na caixa de combinação. Essa representação de conteúdo é especificada pela DisplayMember propriedade. Se a DisplayMember propriedade for null, o método do ToString item será chamado para obter a cadeia de caracteres exibida na caixa de combinação; caso contrário, a propriedade do objeto armazenado, conforme especificado pela DisplayMember propriedade, será exibida. Para adicionar um conjunto de itens à caixa de combinação, é melhor usar o AddRange método. Se você optar por usar o Add método para adicionar um conjunto de itens à caixa de combinação, use o BeginUpdate método para suspender a repintagem durante a adição e o EndUpdate método para retomar a repintagem. Você pode usar o Insert método para especificar o local na lista em que um item é adicionado. Quando um objeto é adicionado à coleção, chama o ComboBox método do ToString objeto para obter a cadeia de caracteres a ser exibida na lista.

Confira também

• IList