CurrencyManager.SuspendBinding Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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.

Dotyczy

Zobacz też