ComboBox.BeginUpdate Méthode

Définition

Gère les performances quand les éléments sont ajoutés au ComboBox un par un.Maintains performance when items are added to the ComboBox one at a time.

public:
 void BeginUpdate();
public void BeginUpdate ();
member this.BeginUpdate : unit -> unit
Public Sub BeginUpdate ()

Exemples

L’exemple de code suivant illustre l’utilisation des méthodes BeginUpdate et EndUpdate.The following code example shows the usage of the BeginUpdate and EndUpdate methods. L’exemple fait partie d’un exemple de code complet dans la vue d’ensemble de la classe ComboBox.The example is part of a complete code example in the ComboBox class overview.

void addGrandButton_Click( Object^ sender, System::EventArgs^ e )
{
   comboBox1->BeginUpdate();
   for ( int i = 0; i < 1000; i++ )
   {
      comboBox1->Items->Add( "New Item " + i.ToString() );
   }
   comboBox1->EndUpdate();
}
private void addGrandButton_Click(object sender, System.EventArgs e) {
    comboBox1.BeginUpdate();
    for (int i = 0; i < 1000; i++) {
        comboBox1.Items.Add("New Item " + i.ToString());
    }
    comboBox1.EndUpdate();
}
Private Sub addGrandButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    comboBox1.BeginUpdate()
    Dim I As Integer
    For I = 0 To 1000
        comboBox1.Items.Add("New Item " + i.ToString())
    Next
    comboBox1.EndUpdate()
End Sub

Remarques

Cette méthode empêche le contrôle de se peindre jusqu’à ce que la méthode EndUpdate soit appelée.This method prevents the control from painting until the EndUpdate method is called.

La meilleure façon d’ajouter des éléments à la ComboBox consiste à utiliser la méthode AddRange de la classe ComboBox.ObjectCollection (via la propriété Items de l' ComboBox).The preferred way to add items to the ComboBox is to use the AddRange method of the ComboBox.ObjectCollection class (through the Items property of the ComboBox). Cela vous permet d’ajouter un tableau d’éléments à la liste en même temps.This enables you to add an array of items to the list at one time. Toutefois, si vous souhaitez ajouter des éléments l’un après l’autre à l’aide de la méthode Add de la classe ComboBox.ObjectCollection, vous pouvez utiliser la méthode BeginUpdate pour empêcher le contrôle de repeindre les ComboBox chaque fois qu’un élément est ajouté à la liste.However, if you want to add items one at a time using the Add method of the ComboBox.ObjectCollection class, you can use the BeginUpdate method to prevent the control from repainting the ComboBox each time an item is added to the list. Une fois que vous avez terminé la tâche d’ajout d’éléments à la liste, appelez la méthode EndUpdate pour permettre au ComboBox de repeindre.Once you have completed the task of adding items to the list, call the EndUpdate method to enable the ComboBox to repaint. Cette méthode d’ajout d’éléments peut empêcher le scintillement lors du dessin de l' ComboBox lorsqu’un grand nombre d’éléments est ajouté à la liste.This way of adding items can prevent flicker during the drawing of the ComboBox when a large number of items are being added to the list.

S’applique à