ComboBox.ObjectCollection.AddRange(Object[]) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega una matriz de elementos a la lista de elementos de ComboBox.

public void AddRange (object[] items);

Parámetros

items

Object[]

Matriz de objetos que se van a agregar a la lista.

Excepciones

ArgumentNullException

Un elemento del parámetro items era null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo inicializar un ComboBox control estableciendo la propiedad text y usando el AddRange método para rellenar .ComboBox También muestra cómo controlar el DropDown evento. Para ejecutar el ejemplo, pegue el código siguiente en un formulario y llame al InitializeComboBox método desde el constructor o Load método del formulario.

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

Comentarios

Si la Sorted propiedad de ComboBox se establece en true, los elementos se insertan alfabéticamente en la lista. De lo contrario, los elementos se insertan en el orden en que se producen dentro de la matriz. Este método se suele pasar a una matriz de String objetos, pero se puede pasar una matriz de cualquier tipo de objeto a este método. Cuando se agrega un objeto a la colección, el método llama al método del ToString objeto para obtener la cadena que se mostrará en la lista. Al usar este método para agregar elementos a la colección, no es necesario llamar a los métodos y EndUpdate para optimizar el BeginUpdate rendimiento.

Se aplica a