ListBox.EndUpdate 方法

在 BeginUpdate 方法挂起绘制后，该方法恢复绘制 ListBox 控件。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Sub EndUpdate
用法
Dim instance As ListBox

instance.EndUpdate

public void EndUpdate ()

public:
void EndUpdate ()

public void EndUpdate ()

public function EndUpdate ()

备注

向 ListBox 添加项的首选方法是使用 ListBox.ObjectCollection 类的 AddRange 方法（通过使用 ListBox 的 Items 属性）。这使您可以一次向列表添加一组项。但是，如果想使用 ListBox.ObjectCollection 类的 Add 方法一次添加一项，则可以使用 BeginUpdate 方法，以防止每次向列表添加项时控件都重新绘制 ListBox。完成向列表添加项的任务后，调用 EndUpdate 方法来使 ListBox 能够重新绘制。当向列表添加大量的项时，使用这种方法添加项可以防止绘制 ListBox 时闪烁。

示例

下面的代码示例使用 BeginUpdate 和 EndUpdate 方法向 ListBox 添加五千个项。本示例要求已将名为 listBox1 的 ListBox 控件添加到 Form 中，并且此方法被放置在该窗体中，从该窗体进行调用。

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

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0

请参见

参考

ListBox 类
ListBox 成员
System.Windows.Forms 命名空间
BeginUpdate