ListBox.EndUpdate-Methode

Nimmt das Zeichnen des ListBox-Steuerelements wieder auf, nachdem der Vorgang durch die BeginUpdate-Methode angehalten wurde.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub EndUpdate
'Usage
Dim instance As ListBox

instance.EndUpdate

public void EndUpdate ()

public:
void EndUpdate ()

public void EndUpdate ()

public function EndUpdate ()

Hinweise

Die empfohlene Vorgehensweise um der ListBox Elemente hinzuzufügen besteht im Verwenden der AddRange-Methode der ListBox.ObjectCollection-Klasse (über die Items-Eigenschaft der ListBox). So können Sie der Liste ein Array von Elementen auf einmal hinzufügen. Wenn Sie allerdings Elemente einzeln mithilfe der Add-Methode der ListBox.ObjectCollection-Klasse hinzufügen möchten, können Sie mithilfe der BeginUpdate-Methode verhindern, dass ListBox jedes Mal neu aufgebaut wird, wenn der Liste ein neues Element hinzugefügt wird. Sobald der Vorgang des Hinzufügens von Elementen zur Liste abgeschlossen ist, rufen Sie die EndUpdate-Methode auf, damit die ListBox neu aufgebaut werden kann. Durch diese Vorgehensweise beim Hinzufügen von Elementen kann das Flackern beim Zeichnen der ListBox verhindert werden, das entsteht, wenn der Liste eine große Zahl von Elementen hinzugefügt wird.

Beispiel

Im folgenden Codebeispiel werden die BeginUpdate-Methode und die EndUpdate-Methode verwendet, während einer ListBox 5000 Elemente hinzugefügt werden. Für dieses Beispiel muss einem Form das ListBox-Steuerelement listBox1 hinzugefügt werden; außerdem muss diese Methode im Formular platziert und aus diesem aufgerufen werden.

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

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();
}

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.get_Items().Add(("Item" + (new Integer(x)).ToString()));
    }

    // End the update process and force a repaint of the ListBox.
    listBox1.EndUpdate();
} //AddToMyListBox

function AddToMyListBox(){
    // Stop the ListBox from drawing while items are added.
    listBox1.BeginUpdate()
       
    // Loop through and add five thousand new items.
    for(var x = 0; x < 5000; x++)
        listBox1.Items.Add("Item " + x.ToString())
    // End the update process and force a repaint of the ListBox.
    listBox1.EndUpdate()
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

ListBox-Klasse
ListBox-Member
System.Windows.Forms-Namespace
BeginUpdate