ListBox.BeginUpdate Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListBox.cs

Conserve les performances pendant que les éléments sont ajoutés à celui-ci à la ListBox fois en empêchant le contrôle de dessiner jusqu’à ce que la EndUpdate() méthode soit appelée.

public:
 void BeginUpdate();

public void BeginUpdate();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Exemples

L’exemple de code suivant utilise les méthodes et EndUpdate les BeginUpdate méthodes tout en ajoutant cinq mille éléments à un ListBox. Cet exemple nécessite qu’un ListBox contrôle nommé listBox1a été ajouté à un Form contrôle et que cette méthode soit placée dans le formulaire et appelée à partir de celle-ci.

void AddToMyListBox()
{
   // Stop the ListBox from drawing while items are added.
   listBox1->BeginUpdate();

   // Loop through and add five thousand new items.
   for ( int x = 1; x < 5000; x++ )
   {
      listBox1->Items->Add( String::Format( "Item {0}", x ) );
   }
   listBox1->EndUpdate();
}

public void AddToMyListBox()
{
   // Stop the ListBox from drawing while items are added.
   listBox1.BeginUpdate();

   // Loop through and add five thousand new items.
   for(int x = 1; x < 5000; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());   
   }
   // End the update process and force a repaint of the ListBox.
   listBox1.EndUpdate();
}

Public Sub AddToMyListBox()
    ' Stop the ListBox from drawing while items are added.
    listBox1.BeginUpdate()
       
    ' Loop through and add five thousand new items.
    Dim x As Integer
    For x = 1 To 4999
        listBox1.Items.Add("Item " & x.ToString())
    Next x
    ' End the update process and force a repaint of the ListBox.
    listBox1.EndUpdate()
End Sub

Remarques

La méthode recommandée pour ajouter plusieurs éléments à la ListBox classe consiste à utiliser la AddRange méthode de la ListBox.ObjectCollection classe (via la Items propriété du ListBox). Cela vous permet d’ajouter un tableau d’éléments à la liste dans une seule opération. Toutefois, si vous souhaitez ajouter des éléments un par un à la fois à l’aide de la Add méthode de la ListBox.ObjectCollection classe, vous pouvez utiliser la BeginUpdate méthode pour empêcher le contrôle de repeindre chaque ListBox fois qu’un élément est ajouté à la liste. Une fois que vous avez terminé la tâche d’ajouter des éléments à la liste, appelez la EndUpdate méthode pour activer le ListBox repeint. Cette façon d’ajouter des éléments peut empêcher le dessin scintillement du ListBox moment où un grand nombre d’éléments sont ajoutés à la liste.

Voir aussi

• EndUpdate()