CurrencyManager.SuspendBinding Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

CurrencyManager.cs

Suspend la liaison de données pour empêcher la mise à jour de 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 montre comment utiliser la SuspendBinding méthode.

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 ResumeBinding permettent la suspension temporaire et la reprise de la liaison de données dans un scénario de liaison simple. En règle générale, vous suspendez la liaison de données si l’utilisateur doit apporter plusieurs modifications aux champs de données avant la validation. Par exemple, si un champ doit être modifié conformément à une seconde, mais si la validation du premier champ entraîne l’erreur du deuxième champ.

Note

SuspendBinding empêche l’application des modifications à la source de données jusqu’à ResumeBinding ce qu’elle soit appelée, mais n’empêche pas réellement 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 une utilisation avec des contrôles 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é falsesur .

Voir aussi

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