CurrencyManager.SuspendBinding Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wstrzymuje powiązanie danych, aby zapobiec aktualizacji powiązanego źródła danych.
public:
override void SuspendBinding();
public override void SuspendBinding ();
override this.SuspendBinding : unit -> unit
Public Overrides Sub SuspendBinding ()
Przykłady
W poniższym przykładzie kodu pokazano, jak używać SuspendBinding metody .
void button3_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
try
{
BindingManagerBase^ myBindingManager1 = BindingContext[ myDataSet, "Customers" ];
myBindingManager1->SuspendBinding();
}
catch ( Exception^ ex )
{
MessageBox::Show( ex->Source );
MessageBox::Show( ex->Message );
}
}
private void button3_Click(object sender, EventArgs e)
{
try
{
BindingManagerBase myBindingManager1=BindingContext [myDataSet, "Customers"];
myBindingManager1.SuspendBinding();
}
catch(Exception ex)
{
MessageBox.Show(ex.Source);
MessageBox.Show(ex.Message);
}
}
Private Sub button3_Click(sender As Object, e As EventArgs)
Try
Dim myBindingManager1 As BindingManagerBase = BindingContext(myDataSet, "Customers")
myBindingManager1.SuspendBinding()
Catch ex As Exception
MessageBox.Show(ex.Source.ToString())
MessageBox.Show(ex.Message.ToString())
End Try
End Sub
Uwagi
Metody SuspendBinding i ResumeBinding umożliwiają tymczasowe zawieszenie i wznowienie powiązania danych w prostym scenariuszu powiązania. Zwykle powiązanie danych jest zawieszane, jeśli użytkownik musi wprowadzić kilka zmian w polach danych przed zakończeniem walidacji. Jeśli na przykład jedno pole musi zostać zmienione zgodnie z drugim, ale w przypadku, gdy walidacja pierwszego pola spowoduje błąd drugiego pola.
Uwaga
SuspendBinding zapobiega stosowaniu zmian do źródła danych do momentu ResumeBinding wywołania, ale w rzeczywistości nie zapobiega wystąpieniu żadnych zdarzeń. Kontrolki używające złożonego powiązania danych, takiego jak kontrolka DataGridView , aktualizują swoje wartości na podstawie zdarzeń zmiany, takich jak ListChanged zdarzenie. W związku z tym wywołanie SuspendBinding nie uniemożliwi zespolonej kontroli odbierania zdarzeń w celu zaktualizowania źródła danych. Z tego powodu SuspendBinding i ResumeBinding są przeznaczone do użytku z prostymi powiązanymi kontrolkami, takimi jak kontrolka TextBox . Alternatywnie można użyć tych metod w złożonym scenariuszu powiązania, jeśli pomijasz ListChanged zdarzenia, ustawiając RaiseListChangedEvents właściwość na false
.