ComboBox.BeginUpdate メソッド


アイテムを一度に ComboBox に追加するときにパフォーマンスを維持します。Maintains performance when items are added to the ComboBox one at a time.

 void BeginUpdate();
public void BeginUpdate ();
member this.BeginUpdate : unit -> unit
Public Sub BeginUpdate ()

次のコード例は、BeginUpdate メソッドと EndUpdate メソッドの使用方法を示しています。The following code example shows the usage of the BeginUpdate and EndUpdate methods. この例は、ComboBox クラスの概要の完全なコード例の一部です。The example is part of a complete code example in the ComboBox class overview.

void addGrandButton_Click( Object^ sender, System::EventArgs^ e )
   for ( int i = 0; i < 1000; i++ )
      comboBox1->Items->Add( "New Item " + i.ToString() );
private void addGrandButton_Click(object sender, System.EventArgs e) {
    for (int i = 0; i < 1000; i++) {
        comboBox1.Items.Add("New Item " + i.ToString());
Private Sub addGrandButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim I As Integer
    For I = 0 To 1000
        comboBox1.Items.Add("New Item " + i.ToString())
End Sub


このメソッドは、EndUpdate メソッドが呼び出されるまで、コントロールが描画されないようにします。This method prevents the control from painting until the EndUpdate method is called.

ComboBox に項目を追加するには、ComboBoxItems プロパティを使用して ComboBox.ObjectCollection クラスの AddRange メソッドを使用することをお勧めします。The preferred way to add items to the ComboBox is to use the AddRange method of the ComboBox.ObjectCollection class (through the Items property of the ComboBox). これにより、リストに項目の配列を一度に追加できます。This enables you to add an array of items to the list at one time. ただし、ComboBox.ObjectCollection クラスの Add メソッドを使用して一度に1つずつ項目を追加する場合は、BeginUpdate メソッドを使用して、リストに項目が追加されるたびに、コントロールが ComboBox を再描画しないようにすることができます。However, if you want to add items one at a time using the Add method of the ComboBox.ObjectCollection class, you can use the BeginUpdate method to prevent the control from repainting the ComboBox each time an item is added to the list. リストに項目を追加するタスクを完了したら、EndUpdate メソッドを呼び出して、ComboBox を再描画できるようにします。Once you have completed the task of adding items to the list, call the EndUpdate method to enable the ComboBox to repaint. このように項目を追加すると、多数の項目がリストに追加されているときに ComboBox の描画中にちらつきを防ぐことができます。This way of adding items can prevent flicker during the drawing of the ComboBox when a large number of items are being added to the list.