ComboBox.ObjectCollection.AddRange(Object[]) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt der Liste von Elementen für eine ComboBox ein Array von Elementen hinzu.

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

public void AddRange (object[] items);

member this.AddRange : obj[] -> unit

Public Sub AddRange (items As Object())

Parameter

items

Object[]

Ein Array von Objekten, die der Liste hinzugefügt werden sollen.

Ausnahmen

ArgumentNullException

Ein Element im items-Parameter ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein ComboBox Steuerelement initialisieren, indem Sie die text-Eigenschaft festlegen und die AddRange -Methode zum Auffüllen verwenden ComboBox. Außerdem wird die Behandlung des Ereignisses DropDown veranschaulicht. Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein, und rufen Sie die InitializeComboBox -Methode aus dem Konstruktor oder Load der 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 von ComboBox 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 als 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 die -Methode des ToString Objekts auf, um die Zeichenfolge abzurufen, die in der Liste angezeigt werden soll. Wenn Sie diese Methode zum Hinzufügen von Elementen zur Auflistung verwenden, müssen Sie die Methoden und EndUpdate nicht aufrufen, um die BeginUpdate Leistung zu optimieren.