ComboBox.ObjectCollection.AddRange(Object[]) Methode

public:
 void AddRange(cli::array <System::Object ^> ^ items);

public:
 void AddRange(... cli::array <System::Object ^> ^ items);

public void AddRange(object[] items);

public void AddRange(params object[] items);

member this.AddRange : obj[] -> unit

Public Sub AddRange (items As Object())

Public Sub AddRange (ParamArray items As Object())

Parameter

Ausnahmen

Beispiele

Das folgende Codebeispiel veranschaulicht das Initialisieren eines ComboBox Steuerelements durch Festlegen der Texteigenschaft und Verwenden der AddRange Methode zum Auffüllen des ComboBoxSteuerelements. Außerdem wird die Behandlung des DropDown Ereignisses veranschaulicht. Zum Ausführen des Beispiels fügen Sie den folgenden Code in ein Formular ein, und rufen Sie die Methode aus dem Konstruktor oder Load der InitializeComboBox Methode des Formulars auf.

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

Hinweise

Wenn die Sorted Eigenschaft des ComboBox Objekts auf "true" festgelegt ist, werden die Elemente alphabetisch in die Liste eingefügt. Andernfalls werden die Elemente in der Reihenfolge eingefügt, in der sie innerhalb des Arrays auftreten. Diese Methode wird in der Regel an ein Array von String Objekten übergeben, aber ein Array eines beliebigen Objekttyps kann an diese Methode übergeben werden. Wenn der Auflistung ein Objekt hinzugefügt wird, ruft die Methode das Objekt ToString auf, um die Zeichenfolge abzurufen, die in der Liste angezeigt werden soll. Wenn Sie diese Methode zum Hinzufügen von Elementen zur Sammlung verwenden, müssen Sie die Leistung nicht aufrufen und EndUpdate keine Methoden aufrufen, um die BeginUpdate Leistung zu optimieren.