BindingSource.ResetItem(Int32) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Faz com que um controle associado ao BindingSource releia o item no índice especificado e atualize o valor exibido.

public:
 void ResetItem(int itemIndex);

public void ResetItem (int itemIndex);

member this.ResetItem : int -> unit

Public Sub ResetItem (itemIndex As Integer)

Parâmetros

itemIndex: Int32

O índice com base em zero do item que foi alterado.

Exemplos

O exemplo de código a seguir usa um BindingSource componente para associar uma lista a um DataGridView controle. A lista não gera notificações de alteração, portanto, o ResetItem método no BindingSource é usado para gerar o ListChanged evento. Este exemplo de código faz parte de um exemplo maior fornecido em Como gerar notificações de alteração usando o método BindingSource ResetItem.

// This event handler changes the value of the CompanyName
// property for the first item in the list.
void changeItemBtn_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Get a reference to the list from the BindingSource.
   List< DemoCustomer^ >^ customerList =
      static_cast<List< DemoCustomer^ >^>(
        this->customersBindingSource->DataSource);
   
   // Change the value of the CompanyName property for the
   // first item in the list.
   customerList->default[ 0 ]->CompanyName = L"Tailspin Toys";
   
   // Call ResetItem to alert the BindingSource that the
   // list has changed.
   this->customersBindingSource->ResetItem( 0 );
}

// This event handler changes the value of the CompanyName
// property for the first item in the list.
void changeItemBtn_Click(object sender, EventArgs e)
{
    // Get a reference to the list from the BindingSource.
    List<DemoCustomer> customerList = 
        this.customersBindingSource.DataSource as List<DemoCustomer>;

    // Change the value of the CompanyName property for the 
    // first item in the list.
    customerList[0].CompanyName = "Tailspin Toys";

    // Call ResetItem to alert the BindingSource that the 
    // list has changed.
    this.customersBindingSource.ResetItem(0);
}

' This event handler changes the value of the CompanyName
' property for the first item in the list.
Private Sub changeItemBtn_Click(ByVal sender As Object, ByVal e As EventArgs) _
   Handles changeItemBtn.Click

    ' Get a reference to the list from the BindingSource.
    Dim customerList As List(Of DemoCustomer) = _
    CType(Me.customersBindingSource.DataSource, List(Of DemoCustomer))

    ' Change the value of the CompanyName property for the 
    ' first item in the list.
    customerList(0).CompanyName = "Tailspin Toys"

    ' Call ResetItem to alert the BindingSource that the 
    ' list has changed.
    Me.customersBindingSource.ResetItem(0)

End Sub

Comentários

O ResetItem método notifica todos os controles associados ao item no especificado Position para atualizar seus valores. O método faz isso acionando o ListChanged evento com definido ListChangedType.ItemChangedcomo ListChangedEventArgs.ListChangedType .

ResetItem é chamado automaticamente sempre que são feitas alterações no valor de um item individual. No entanto, o programador também pode chamar esse método explicitamente.

Aplica-se a

Partilhar via