BindingSource.ResetBindings(Boolean) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Listedeki tüm öğeleri yeniden okumak ve görüntülenen değerlerini yenilemek için BindingSource öğesine bağlı bir denetime 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 BindingSource bileşen kullanır. 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, How to: Reflect Data Source Güncelleştirmeler in a Windows Forms Control with the BindingSource 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ğerleri 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ış ListChangedType.PropertyDescriptorChangedbir olay oluşturulurListChangedEventArgs.ListChangedType.metaDataChanged
değerifalse
, yalnızca bir veya daha fazla öğenin değerlerinin değiştiğini gösterir.
değerine metaDataChanged
bakılmaksızın, olarak ayarlanmış ListChangedType.Resetbir ListChanged olay oluşturulurListChangedEventArgs.ListChangedType. Sonuç olarak parametresiyle true
çağrılması ResetBindings iki ListChanged olayı tetikler.
ResetBindings , veya özelliklerini ayarlama gibi veri bağlamada önemli değişiklikler yaptığında otomatik olarak çağrılır DataSourceDataMember . Ancak programcı bu yöntemi açıkça da çağırabilir.