ComboBox.ObjectCollection.Add(Object) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona um item à lista de itens para um ComboBox.

public:
 int Add(System::Object ^ item);

public int Add (object item);

member this.Add : obj -> int

Public Function Add (item As Object) As Integer

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.

Exceções

ArgumentNullException

O parâmetro item era null.

Comentários

Esse método adiciona um item à caixa de combinação. Se a Sorted propriedade do ComboBox for definida truecomo , o item será 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. Um SystemException ocorrerá se não houver espaço suficiente disponível para armazenar o novo item. 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 vários itens à caixa de combinação, use o BeginUpdate método para suspender o repositório durante a adição e o EndUpdate método para retomar o repositório. Você pode usar o Insert método para especificar o local na lista em que um item é adicionado. Quando um objeto é adicionado à coleção, o chama o ComboBox método do ToString objeto para obter a cadeia de caracteres a ser exibida na lista.

Confira também

• IList