BindingSource.ResetBindings(Boolean) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

BindingSource.cs

listedeki tüm öğeleri yeniden okumak ve görüntülenen değerlerini yenilemek için BindingSource öğesine bağlı bir denetimin neden olur.

public:
 void ResetBindings(bool metadataChanged);

public void ResetBindings(bool metadataChanged);

member this.ResetBindings : bool -> unit

Public Sub ResetBindings (metadataChanged As Boolean)

Parametreler

metadataChanged

Boolean

true veri şeması değiştiyse; false yalnızca değerler değiştiyse.

Örnekler

Aşağıdaki kod örneği, değişiklik bildirimi sağlamayan bir dizi listesini bağlamak için bir bileşen kullanır BindingSource . Listeden bir öğe kaldırılır ve ilişkili denetimlere yöntemi çağrılarak ResetBindings değişiklik bildirilir. Bu kod örneği, H nasıl yapılır: BindingSource ile Windows Forms Denetiminde Veri Kaynağı Güncelleştirmelerini Yansıtma bölümünde sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

yöntemi, ResetBindings değerlerini yenilemek için öğesine BindingSource bağlı tüm denetimleri bilgilendirmektedir. yöntemi, olayı en az bir kez yükselterek ListChanged bunu yapar; metaDataChanged parametresi, temel değişikliğin doğasını gösterir.

• metaDataChanged değeritrue, veri şemasının BindingSource değiştiğini gösterir. ListChanged olarak ayarlanmış ListChangedEventArgs.ListChangedTypebir ListChangedType.PropertyDescriptorChanged olay oluşturulur.

• metaDataChanged değerifalse, yalnızca bir veya daha fazla öğenin değerlerinin değiştiğini gösterir.

değerinden metaDataChangedbağımsız olarak, olarak ayarlanmış ListChangedbir ListChangedEventArgs.ListChangedTypeListChangedType.Reset olay oluşturulur. Sonuç olarak parametresiyle ResetBindings çağrılması true iki ListChanged olayı tetikler.

ResetBindings , veya özelliklerini ayarlama gibi veri bağlamada önemli değişiklikler yapan başka bir üye olduğunda otomatik olarak çağrılır DataSourceDataMember . Ancak programcı bu yöntemi açıkça da çağırabilir.

Ayrıca bkz.

• List
• ResetItem(Int32)
• ListChanged
• ListChangedType