ComboBox.BeginUpdate ComboBox.BeginUpdate ComboBox.BeginUpdate ComboBox.BeginUpdate Method

定義

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

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

次のコード例は、メソッドBeginUpdateEndUpdateメソッドの使用方法を示しています。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 )
{
   comboBox1->BeginUpdate();
   for ( int i = 0; i < 1000; i++ )
   {
      comboBox1->Items->Add( "New Item " + i.ToString() );
   }
   comboBox1->EndUpdate();
}
private void addGrandButton_Click(object sender, System.EventArgs e) {
    comboBox1.BeginUpdate();
    for (int i = 0; i < 1000; i++) {
        comboBox1.Items.Add("New Item " + i.ToString());
    }
    comboBox1.EndUpdate();
}
Private Sub addGrandButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    comboBox1.BeginUpdate()
    Dim I As Integer
    For I = 0 To 1000
        comboBox1.Items.Add("New Item " + i.ToString())
    Next
    comboBox1.EndUpdate()
End Sub

注釈

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

に項目ComboBoxを追加するには、 ComboBox.ObjectCollectionクラスのAddRangeメソッド ( ItemsのプロパティComboBoxを使用) を使用することをお勧めします。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. Addただし、 ComboBox.ObjectCollectionクラスのメソッドを使用して一度に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.

適用対象