ListBox.BeginUpdate Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ListBox.cs

Поддерживает производительность при добавлении ListBox элементов в один раз, предотвращая рисование элемента управления до EndUpdate() вызова метода.

public:
 void BeginUpdate();

public void BeginUpdate();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Примеры

В следующем примере кода используются BeginUpdate методы и EndUpdate методы при добавлении пяти тысяч элементов в объект ListBox. В этом примере требуется, чтобы ListBox элемент управления с именем listBox1был добавлен в объект Form и что этот метод помещается в форму и вызывается из него.

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

Комментарии

Предпочтительный способ добавления нескольких элементов в ListBox класс — использовать AddRange метод ListBox.ObjectCollection класса (через Items свойство объекта ListBox). Это позволяет добавлять массив элементов в список в одной операции. Однако если вы хотите добавить элементы по одному за раз с помощью Add метода ListBox.ObjectCollection класса, можно использовать BeginUpdate метод, чтобы запретить элементу управления повторно переопределить ListBox каждый раз, когда элемент добавляется в список. После завершения задачи добавления элементов в список вызовите EndUpdate метод, чтобы включить ListBox повторную настройку. Этот способ добавления элементов может предотвратить мелькание рисунка ListBox при добавлении большого количества элементов в список.

См. также раздел

• EndUpdate()