BindingSource.ResetBindings(Boolean) Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

BindingSource.cs

A lista összes elemének újraolvasásához BindingSource és a megjelenített értékek frissítéséhez a vezérlőhöz kötött vezérlőelemet okoz.

public:
 void ResetBindings(bool metadataChanged);

public void ResetBindings(bool metadataChanged);

member this.ResetBindings : bool -> unit

Public Sub ResetBindings (metadataChanged As Boolean)

Paraméterek

metadataChanged

Boolean

true ha az adatséma megváltozott; false ha csak az értékek módosultak.

Példák

Az alábbi példakód egy összetevőt használ egy BindingSource tömblista kötéséhez, amely nem ad meg változásértesítést. A rendszer eltávolít egy elemet a listából, és a kötött vezérlők a metódus meghívásával értesítést kapnak a ResetBindings változásról. Ez a példakód a Hogyan is: Az adatforrás frissítéseinek tükrözése egy Windows Forms-vezérlőben a BindingSource-ben.

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

Megjegyzések

A ResetBindings metódus tájékoztatja az értékek frissítéséhez BindingSource kötött összes vezérlőt. A módszer ezt úgy teszi, hogy legalább egyszer felemeli az ListChanged eseményt; a metaDataChanged paraméter a mögöttes változás természetét jelzi.

• Egy metaDataChanged érték true azt jelzi, hogy az adatséma BindingSource megváltozott. Egy ListChanged esemény a következőre ListChangedEventArgs.ListChangedType van állítva ListChangedType.PropertyDescriptorChanged: .

• Egy metaDataChanged érték false azt jelzi, hogy csak egy vagy több elem értéke módosult.

A rendszer az értéktől metaDataChangedListChanged függetlenül egy eseményt a következő értékre ListChangedEventArgs.ListChangedType állít beListChangedType.Reset: . Ennek következtében a paraméterrel történő ResetBindings hívás true két ListChanged eseményt fog előhozni.

ResetBindingsa rendszer automatikusan meghívja, amikor egy másik tag jelentős módosításokat végez az adatkötésen, például beállítja a DataSource tulajdonságokat.DataMember A programozó azonban explicit módon is meghívhatja ezt a módszert.

Lásd még

• List
• ResetItem(Int32)
• ListChanged
• ListChangedType