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

Définition

Ajoute un tableau d'éléments à la liste d'éléments pour 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())

Paramètres

items
Object[]

Tableau d'objets à ajouter à la liste.An array of objects to add to the list.

Exceptions

Un élément dans le paramètre items était null.An item in the items parameter was null.

Exemples

L’exemple de code suivant montre comment initialiser un ComboBox contrôle en définissant la propriété Text et en AddRange utilisant la méthode pour ComboBoxremplir le.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. Il montre également comment gérer DropDown l’événement.It also demonstrates handling the DropDown event. Pour exécuter l’exemple, collez le code suivant dans un formulaire et appelez InitializeComboBox la méthode à partir de la méthode Load ou du constructeur du formulaire.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

Remarques

Si la Sorted propriété ComboBox du a la valeur true, les éléments sont insérés dans la liste par ordre alphabétique.If the Sorted property of the ComboBox is set to true, the items are inserted into the list alphabetically. Dans le cas contraire, les éléments sont insérés dans l’ordre dans lequel ils apparaissent dans le tableau.Otherwise, the items are inserted in the order they occur within the array. Cette méthode est généralement passée un tableau d' String objets, mais un tableau de tout type d’objet peut être passé à cette méthode.This method is typically passed an array of String objects, but an array of any type of object can be passed to this method. Lorsqu’un objet est ajouté à la collection, la méthode appelle la méthode de ToString l’objet pour obtenir la chaîne à afficher dans la liste.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. Lors de l’utilisation de cette méthode pour ajouter des éléments à la collection, il n’est BeginUpdate pas EndUpdate nécessaire d’appeler les méthodes et pour optimiser les performances.When using this method to add items to the collection, you do not need to call the BeginUpdate and EndUpdate methods to optimize performance.

S’applique à