ListBox.BeginUpdate Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ListBox.cs

Mantiene le prestazioni mentre gli elementi vengono aggiunti a ListBox uno alla volta impedendo al controllo di disegnare fino a quando non viene chiamato il EndUpdate() metodo .

public:
 void BeginUpdate();

public void BeginUpdate();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Esempio

Nell'esempio di codice seguente vengono utilizzati i metodi e durante l'aggiunta BeginUpdate di cinquemila elementi a un oggetto ListBox.EndUpdate In questo esempio è necessario che un ListBox controllo denominato listBox1sia stato aggiunto a e Form che questo metodo venga inserito all'interno del form e chiamato da esso.

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

Commenti

Il modo preferito per aggiungere più elementi a ListBox è usare il AddRange metodo della ListBox.ObjectCollection classe (tramite la Items proprietà di ListBox). In questo modo è possibile aggiungere una matrice di elementi all'elenco in una singola operazione. Tuttavia, se si desidera aggiungere elementi uno alla volta usando il Add metodo della ListBox.ObjectCollection classe , è possibile utilizzare il BeginUpdate metodo per impedire al controllo di ridipingere ogni ListBox volta che un elemento viene aggiunto all'elenco. Dopo aver completato l'attività di aggiunta di elementi all'elenco, chiamare il EndUpdate metodo per abilitare l'aggiornamento dell'oggetto ListBox . Questo modo di aggiungere elementi può impedire il disegno sfarfallio di quando ListBox viene aggiunto un numero elevato di elementi all'elenco.

Vedi anche

• EndUpdate()