ComboBox.ObjectCollection.Add(Object) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un elemento a la lista de elementos de un control 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

Objeto que representa el elemento que se va a agregar a la colección.

Devoluciones

Int32

El índice de base cero del elemento de la colección.

Excepciones

ArgumentNullException

El parámetro item era null.

Comentarios

Este método agrega un elemento al cuadro combinado. Si la Sorted propiedad de ComboBox se establece trueen , el elemento se inserta en la lista alfabéticamente. De lo contrario, el elemento se inserta al final de la lista.

En el cuadro combinado se muestra una representación visual del elemento. Esta representación de contenido se especifica mediante la DisplayMember propiedad . Si la DisplayMember propiedad es null, se llama al método del ToString elemento para obtener la cadena que se muestra en el cuadro combinado; de lo contrario, se muestra la propiedad del objeto almacenado según lo especificado por la DisplayMember propiedad . Se SystemException produce si no hay suficiente espacio disponible para almacenar el nuevo elemento. Para agregar un conjunto de elementos al cuadro combinado, es mejor usar el AddRange método . Si decide usar el método para agregar una serie de elementos al cuadro combinado, use el BeginUpdate método para suspender el reintentos durante la Add adición y el método para reanudar el EndUpdate reintentos. Puede usar el Insert método para especificar la ubicación en la lista donde se agrega un elemento. Cuando se agrega un objeto a la colección, ComboBox llama al método del ToString objeto para obtener la cadena que se va a mostrar en la lista.

Consulte también

• IList