BindingSource.ResetBindings(Boolean) BindingSource.ResetBindings(Boolean) BindingSource.ResetBindings(Boolean) BindingSource.ResetBindings(Boolean) Method

Definición

Hace que un control enlazado a BindingSource vuelva a leer todos los elementos de la lista y actualice los valores mostrados.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)

Parámetros

metadataChanged
Boolean Boolean Boolean Boolean

true Si ha cambiado el esquema de datos; false si solo han cambiado los valores.true if the data schema has changed; false if only values have changed.

Ejemplos

El siguiente ejemplo de código utiliza un BindingSource componente para enlazar una lista de matrices, que no proporciona notificación de cambio.The following code example uses a BindingSource component to bind an array list, which does not provide change notification. Se quita un elemento de la lista y los controles enlazados se notificarán el cambio mediante una llamada a la ResetBindings método.An item is removed from the list, and the bound controls are notified of the change by calling the ResetBindings method. Este ejemplo de código forma parte de un ejemplo más extenso incluido en Cómo: Reflejar las actualizaciones del origen de datos en un Control de Windows Forms con 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 'button1_Click

Comentarios

El ResetBindings método informa a todos los controles enlazados a la BindingSource para actualizar sus valores.The ResetBindings method informs all controls bound to the BindingSource to refresh their values. El método funciona generando la ListChanged eventos al menos una vez; el metaDataChanged parámetro indica la naturaleza del cambio subyacente.The method does this by raising the ListChanged event at least once; the metaDataChanged parameter indicates the nature of the underlying change.

Independientemente del valor de metaDataChanged, un ListChanged evento se desencadena con ListChangedEventArgs.ListChangedType establecido en ListChangedType.Reset.Regardless of the value of metaDataChanged, a ListChanged event is raised with ListChangedEventArgs.ListChangedType set to ListChangedType.Reset. Como consecuencia, llamar a ResetBindings con un parámetro de true generará dos ListChanged eventos.As a consequence, calling ResetBindings with a parameter of true will raise two ListChanged events.

ResetBindings se llama automáticamente siempre que otro miembro realiza cambios significativos en el enlace de datos, como establecer el DataSource o DataMember propiedades.ResetBindings is automatically called whenever another member makes major changes to the data-binding, such as setting the DataSource or DataMember properties. 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: