ComboBox.ObjectCollection.AddRange(Object[]) Metodo

Definizione

Aggiunge una matrice di elementi all'elenco di elementi per un oggetto ComboBox.Adds an array of items to the list of items for a ComboBox.

public:
 void AddRange(cli::array <System::Object ^> ^ items);
public void AddRange (object[] items);
member this.AddRange : obj[] -> unit
Public Sub AddRange (items As Object())

Parametri

items
Object[]

Matrice di oggetti da aggiungere all'elenco.An array of objects to add to the list.

Eccezioni

Un elemento nel parametro items era null.An item in the items parameter was null.

Esempi

Nell'esempio di codice seguente viene illustrato come inizializzare un ComboBox controllo impostando la proprietà Text e utilizzando il AddRange metodo per ComboBoxpopolare.The following code example demonstrates how to initialize a ComboBox control by setting the text property and using the AddRange method to populate the ComboBox. Viene inoltre illustrato come gestire DropDown l'evento.It also demonstrates handling the DropDown event. Per eseguire l'esempio, incollare il codice seguente in un form e chiamare il InitializeComboBox metodo dal costruttore o Load dal metodo del form.To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

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

// 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);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Commenti

Se la Sorted proprietà ComboBox di è impostata su true, gli elementi vengono inseriti nell'elenco in ordine alfabetico.If the Sorted property of the ComboBox is set to true, the items are inserted into the list alphabetically. In caso contrario, gli elementi vengono inseriti nell'ordine in cui si verificano all'interno della matrice.Otherwise, the items are inserted in the order they occur within the array. Questo metodo viene in genere passato a una String matrice di oggetti, ma a questo metodo è possibile passare una matrice di qualsiasi tipo di oggetto.This method is typically passed an array of String objects, but an array of any type of object can be passed to this method. Quando un oggetto viene aggiunto alla raccolta, il metodo chiama il ToString metodo dell'oggetto per ottenere la stringa da visualizzare nell'elenco.When an object is added to the collection, the method calls the object's ToString method to obtain the string to display in the list. Quando si usa questo metodo per aggiungere elementi alla raccolta, non è necessario chiamare i metodi e BeginUpdate EndUpdate per ottimizzare le prestazioni.When using this method to add items to the collection, you do not need to call the BeginUpdate and EndUpdate methods to optimize performance.

Si applica a