BindingSource.ResetItem(Int32) BindingSource.ResetItem(Int32) BindingSource.ResetItem(Int32) BindingSource.ResetItem(Int32) Method

Definición

Hace que un control enlazado a la BindingSource para leer el elemento en el índice especificado y actualice su valor mostrado.Causes a control bound to the BindingSource to reread the item at the specified index, and refresh its displayed value.

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 Int32 Int32 Int32

Índice de base cero del elemento que ha cambiado.The zero-based index of the item that has changed.

Ejemplos

El siguiente ejemplo de código utiliza un BindingSource componente para enlazar una lista a un DataGridView control.The following code example uses a BindingSource component to bind a list to a DataGridView control. La lista no provoca notificaciones de cambios, por lo que la ResetItem método en el BindingSource se usa para generar el ListChanged eventos.The list does not raise change notifications, so the ResetItem method on the BindingSource is used to raise the ListChanged event. Este ejemplo de código forma parte de un ejemplo más extenso incluido en Cómo: Provocar notificaciones de cambios mediante el método ResetItem de BindingSource.This code example is part of a larger example provided in How to: Raise Change Notifications Using the BindingSource ResetItem Method.

// 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

Comentarios

El ResetItem método notifica todos los controles enlazados al elemento en el índice especificado Position para actualizar sus valores.The ResetItem method notifies all controls bound to the item at the specified Position to refresh their values. El método funciona generando la ListChanged eventos con ListChangedEventArgs.ListChangedType establecido en ListChangedType.ItemChanged.The method does this by raising the ListChanged event with ListChangedEventArgs.ListChangedType set to ListChangedType.ItemChanged.

ResetItem se llama automáticamente cada vez que se realizan cambios en el valor de un elemento individual.ResetItem is automatically called whenever changes are made to the value of an individual item. Sin embargo, el programador también puede llamar a este método explícitamente.However, the programmer can also call this method explicitly.

Se aplica a

Consulte también: