ListBox.BeginUpdate Methode

public:
 void BeginUpdate();

public void BeginUpdate();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Beispiele

Im folgenden Codebeispiel werden die und die BeginUpdate Methoden verwendet, EndUpdate und zwar beim Hinzufügen von fünftausend Elementen zu einem ListBox. Dieses Beispiel erfordert, dass ein ListBox Steuerelement mit dem Namen listBox1zu einem Form Steuerelement hinzugefügt wurde und dass diese Methode innerhalb des Formulars platziert und von ihm 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 ist ListBox die Verwendung der AddRange Methode der ListBox.ObjectCollection Klasse (über die Items Eigenschaft der ListBoxKlasse). Auf diese Weise können Sie der Liste in einem einzigen Vorgang ein Array von Elementen hinzufügen. Wenn Sie jedoch elemente 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 ListBox Steuerelement jedes Mal aktualisiert wird, wenn ein Element der Liste hinzugefügt wird. Nachdem Sie die Aufgabe zum Hinzufügen von Elementen zur Liste abgeschlossen haben, rufen Sie die EndUpdate Methode auf, um die ListBox Neubeschriftung zu aktivieren. Mit dieser Methode zum Hinzufügen von Elementen kann verhindert werden, dass die Flimmerung der ListBox Elemente geflimmert wird, wenn der Liste eine große Anzahl von Elementen hinzugefügt wird.

Weitere Informationen

• EndUpdate()