CurrencyManager.SuspendBinding Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Unterbricht die Datenbindung, sodass die gebundene Datenquelle nicht durch Änderungen aktualisiert werden kann.

public:
 override void SuspendBinding();
public override void SuspendBinding ();
override this.SuspendBinding : unit -> unit
Public Overrides Sub SuspendBinding ()

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die SuspendBinding-Methode verwenden.

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

Hinweise

Die SuspendBinding Methoden und ResumeBinding ermöglichen die vorübergehende Aussetzung und Wiederaufnahme der Datenbindung in einem einfachen Bindungsszenario. Sie würden die Datenbindung in der Regel anhalten, wenn der Benutzer mehrere Änderungen an Datenfeldern vornehmen muss, bevor die Überprüfung erfolgt. Beispielsweise, wenn ein Feld gemäß einem zweiten geändert werden muss, aber bei der Überprüfung des ersten Felds das zweite Feld fehlerhaft ist.

Hinweis

SuspendBinding verhindert, dass Änderungen auf die Datenquelle angewendet werden, bis ResumeBinding sie aufgerufen werden, aber es wird nicht tatsächlich verhindert, dass Ereignisse auftreten. Steuerelemente, die komplexe Datenbindung verwenden, z. B. das DataGridView -Steuerelement, aktualisieren ihre Werte basierend auf Änderungsereignissen, z. B. dem ListChanged -Ereignis. Das Aufrufen SuspendBinding verhindert daher nicht, dass komplexe Steuerelemente Ereignisse empfangen, um die Datenquelle zu aktualisieren. Aus diesem Grund SuspendBinding sind und ResumeBinding für die Verwendung mit einfach gebundenen Steuerelementen, z. B. dem TextBox -Steuerelement, konzipiert. Alternativ können Sie diese Methoden in einem komplexen Bindungsszenario verwenden, wenn Sie Ereignisse unterdrücken ListChanged , indem Sie die RaiseListChangedEvents -Eigenschaft auf falsefestlegen.

Gilt für:

Weitere Informationen