ListBox.BeginUpdate Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Erhält die Leistung aufrecht, während der ListBox Elemente einzeln hinzugefügt werden, indem das Zeichnen des Steuerelements bis zum Aufruf der EndUpdate()-Methode verhindert wird.

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Beispiele

Im folgenden Codebeispiel werden die BeginUpdate Methoden und EndUpdate verwendet, während fünftausend Elemente zu einer ListBoxhinzugefügt werden. Dieses Beispiel erfordert, dass ein ListBox Steuerelement mit dem Namen listBox1hinzugefügt wurde Form und dass diese Methode innerhalb des Formulars platziert und von diesem aufgerufen wird.

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

Hinweise

Die bevorzugte Methode zum Hinzufügen mehrerer Elemente zu ist ListBox die Verwendung der AddRange -Methode der ListBox.ObjectCollection -Klasse (über die Items -Eigenschaft von ListBox). Dadurch können Sie der Liste in einem einzelnen Vorgang ein Array von Elementen hinzufügen. Wenn Sie elemente jedoch einzeln mithilfe der Add -Methode der ListBox.ObjectCollection -Klasse hinzufügen möchten, können Sie die BeginUpdate -Methode verwenden, um zu verhindern, dass das Steuerelement jedes ListBox Mal, wenn ein Element der Liste hinzugefügt wird, neu gezeichnet wird. Nachdem Sie die Aufgabe zum Hinzufügen von Elementen zur Liste abgeschlossen haben, rufen Sie die EndUpdate -Methode auf, um das ListBox neu zu streichen. Diese Methode zum Hinzufügen von Elementen kann das Flimmern des ListBox verhindern, wenn der Liste eine große Anzahl von Elementen hinzugefügt wird.

Weitere Informationen

• EndUpdate()