BindingSource.ResetItem(Int32) Método

Definición

Hace que un control enlazado al BindingSource vuelva a leer el elemento situado 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

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

Ejemplos

En el ejemplo de código siguiente BindingSource se usa un componente para enlazar DataGridView una lista a un control.The following code example uses a BindingSource component to bind a list to a DataGridView control. La lista no genera notificaciones de cambios, por lo ResetItem que el método BindingSource en se utiliza para generar ListChanged el evento.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 grande proporcionado en cómo: Genere notificaciones de cambios mediante el métodoResetItem 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 a todos los controles enlazados al elemento en el Position especificado para actualizar sus valores.The ResetItem method notifies all controls bound to the item at the specified Position to refresh their values. Para ello, el método genera el ListChanged evento con ListChangedEventArgs.ListChangedType establecido en ListChangedType.ItemChanged.The method does this by raising the ListChanged event with ListChangedEventArgs.ListChangedType set to ListChangedType.ItemChanged.

ResetItemse llama automáticamente cuando 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: