BindingSource.ResetBindings(Boolean) Methode

Definition

Führt dazu, dass in ein an BindingSource gebundenes Steuerelement alle Elemente in der Liste erneut eingelesen und ihre angezeigten Werte aktualisiert werden.Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

public:
 void ResetBindings(bool metadataChanged);
public void ResetBindings (bool metadataChanged);
member this.ResetBindings : bool -> unit
Public Sub ResetBindings (metadataChanged As Boolean)

Parameter

metadataChanged
Boolean

true, wenn sich das Datenschema geändert hat, false, wenn sich nur Werte geändert haben.true if the data schema has changed; false if only values have changed.

Beispiele

Im folgenden Codebeispiel wird eine BindingSource Komponente verwendet, um eine Array Liste zu binden, die keine Änderungs Benachrichtigung bereitstellt.The following code example uses a BindingSource component to bind an array list, which does not provide change notification. Ein Element wird aus der Liste entfernt, und die gebundenen Steuerelemente werden über die Änderung benachrichtigt, indem die ResetBindings-Methode aufgerufen wird.An item is removed from the list, and the bound controls are notified of the change by calling the ResetBindings method. Dieses Codebeispiel ist Teil eines größeren Beispiels in Gewusst wie: reflektieren von Datenquellen Aktualisierungen in einem Windows Forms-Steuerelement mit der BindingSource.This code example is part of a larger example provided in How to: Reflect Data Source Updates in a Windows Forms Control with the BindingSource.

private:
   void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      String^ xml = "<US><states>"
         + "<state><name>Washington</name><capital>Olympia</capital> "
         + "<flower>Coast Rhododendron</flower></state>"
         + "<state><name>Oregon</name><capital>Salem</capital>"
         + "<flower>Oregon Grape</flower></state>"
         + "<state><name>California</name><capital>Sacramento</capital>"
         + "<flower>California Poppy</flower></state>"
         + "<state><name>Nevada</name><capital>Carson City</capital>"
         + "<flower>Sagebrush</flower></state>"
         + "</states></US>";
      
      // Convert the xml string to bytes and load into a memory stream.
      array<Byte>^ xmlBytes = Encoding::UTF8->GetBytes( xml );
      MemoryStream^ stream = gcnew MemoryStream( xmlBytes,false );
      
      // Create a DataSet and load the xml into it.
      dataSet2->ReadXml( stream );
      
      // Set the data source.
      bindingSource1->DataSource = dataSet2;
      bindingSource1->ResetBindings( true );
   }
private void button1_Click(object sender, EventArgs e)
{
    // If items remain in the list, remove the first item. 
    if (states.Count > 0)
    {
        states.RemoveAt(0);

        // Call ResetBindings to update the textboxes.
        bindingSource1.ResetBindings(false);
    }
}

Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    ' If items remain in the list, remove the first item. 
    If states.Count > 0 Then
        states.RemoveAt(0)

        ' Call ResetBindings to update the textboxes.
        bindingSource1.ResetBindings(False)
    End If

End Sub

Hinweise

Die ResetBindings-Methode informiert alle Steuerelemente, die an den BindingSource gebunden sind, um ihre Werte zu aktualisieren.The ResetBindings method informs all controls bound to the BindingSource to refresh their values. Die-Methode bewirkt dies, indem das ListChanged-Ereignis mindestens einmal angehoben wird. der metaDataChanged-Parameter gibt die Art der zugrunde liegenden Änderung an.The method does this by raising the ListChanged event at least once; the metaDataChanged parameter indicates the nature of the underlying change.

Unabhängig vom Wert metaDataChangedwird ein ListChanged Ereignis ausgelöst, wenn ListChangedEventArgs.ListChangedType auf ListChangedType.Resetfestgelegt ist.Regardless of the value of metaDataChanged, a ListChanged event is raised with ListChangedEventArgs.ListChangedType set to ListChangedType.Reset. Dies hat zur Folge, dass das Aufrufen von ResetBindings mit einem Parameter true zwei ListChanged Ereignisse aufhebt.As a consequence, calling ResetBindings with a parameter of true will raise two ListChanged events.

ResetBindings wird automatisch aufgerufen, wenn ein anderer Member wesentliche Änderungen an der Datenbindung vornimmt, z. b. das Festlegen der DataSource-oder DataMember-Eigenschaften.ResetBindings is automatically called whenever another member makes major changes to the data-binding, such as setting the DataSource or DataMember properties. Der Programmierer kann diese Methode jedoch auch explizit aufzurufen.However, the programmer can also call this method explicitly.

Gilt für:

Siehe auch