ListBox.BeginUpdate Метод

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Поддерживает производительность при добавлении позиций в 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()