ComboBox.BeginUpdate Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Mantém o desempenho quando itens são adicionados ao ComboBox, um de cada vez.

public:
 void BeginUpdate();

public void BeginUpdate ();

member this.BeginUpdate : unit -> unit

Public Sub BeginUpdate ()

Exemplos

O exemplo de código a seguir mostra o uso dos métodos e EndUpdate do BeginUpdate uso. O exemplo faz parte de um exemplo de código completo na visão geral da ComboBox classe.

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

Comentários

Esse método impede que o controle pinte até que o EndUpdate método seja chamado.

A maneira preferencial de adicionar itens ao ComboBox método é usar o AddRange método da ComboBox.ObjectCollection classe (por meio da Items propriedade do ComboBox). Isso permite que você adicione uma matriz de itens à lista ao mesmo tempo. No entanto, se você quiser adicionar itens um de cada vez usando o Add método da ComboBox.ObjectCollection classe, poderá usar o BeginUpdate método para impedir que o controle repinte cada ComboBox vez que um item é adicionado à lista. Depois de concluir a tarefa de adicionar itens à lista, chame o EndUpdate método para habilitar a ComboBox repintar. Essa forma de adicionar itens pode impedir a cintilação durante o desenho do ComboBox quando um grande número de itens está sendo adicionado à lista.