CurrencyManager.SuspendBinding Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Suspend la liaison de données pour empêcher que les modifications mettent à jour la source de données liée.

public:
 override void SuspendBinding();

public override void SuspendBinding ();

override this.SuspendBinding : unit -> unit

Public Overrides Sub SuspendBinding ()

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode SuspendBinding.

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

Remarques

Les SuspendBinding méthodes et ResumeBinding permettent la suspension et la reprise temporaires de la liaison de données dans un scénario de liaison simple. Vous suspendez généralement la liaison de données si l’utilisateur doit apporter plusieurs modifications aux champs de données avant que la validation ne se produise. Par exemple, si un champ doit être modifié en fonction d’un second, mais si la validation du premier champ entraînerait une erreur dans le deuxième champ.

Notes

SuspendBinding empêche l’application de modifications à la source de données jusqu’à ce qu’elle ResumeBinding soit appelée, mais n’empêche pas les événements de se produire. Les contrôles qui utilisent une liaison de données complexe, comme le DataGridView contrôle, mettent à jour leurs valeurs en fonction des événements de modification, tels que l’événement ListChanged . Par conséquent, l’appel SuspendBinding n’empêche pas les contrôles complexes de recevoir des événements pour mettre à jour la source de données. Pour cette raison, SuspendBinding et ResumeBinding sont conçus pour être utilisés avec des contrôles liés simples, tels que le TextBox contrôle. Vous pouvez également utiliser ces méthodes dans un scénario de liaison complexe si vous supprimez ListChanged des événements en définissant la RaiseListChangedEvents propriété sur false.

Voir aussi

• RaiseListChangedEvents
• BindingComplete
• ResumeBinding()
• UpdateIsBinding()
• Bindings