CurrencyManager.SuspendBinding Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
.