BindingSource.ResetItem(Int32) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Führt dazu, dass in ein an BindingSource gebundenes Steuerelement das Element am angegebenen Index erneut eingelesen und sein angezeigter Wert aktualisiert wird.

public:
 void ResetItem(int itemIndex);

public void ResetItem (int itemIndex);

member this.ResetItem : int -> unit

Public Sub ResetItem (itemIndex As Integer)

Parameter

itemIndex

Int32

Der nullbasierte Index des geänderten Elements.

Beispiele

Im folgenden Codebeispiel wird eine BindingSource Komponente verwendet, um eine Liste an ein DataGridView Steuerelement zu binden. Die Liste löst keine Änderungsbenachrichtigungen aus, sodass die ResetItem -Methode für das BindingSource Ereignis ausgelöst ListChanged wird. Dieses Codebeispiel ist Teil eines größeren Beispiels 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

Hinweise

Die ResetItem -Methode benachrichtigt alle Steuerelemente, die an das Element am angegebenen Position gebunden sind, um ihre Werte zu aktualisieren. Die -Methode führt dies durch Auslösen des ListChanged Ereignisses mit ListChangedEventArgs.ListChangedType festgelegt auf ListChangedType.ItemChangedaus.

ResetItem wird automatisch aufgerufen, wenn Änderungen am Wert eines einzelnen Elements vorgenommen werden. Der Programmierer kann diese Methode jedoch auch explizit aufrufen.

Weitere Informationen

• ResetBindings(Boolean)
• Position
• ListChanged
• ListChangedType