CurrencyManager.SuspendBinding Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Onderbreekt de gegevensbinding om te voorkomen dat wijzigingen de afhankelijke gegevensbron bijwerken.
public:
override void SuspendBinding();public override void SuspendBinding();override this.SuspendBinding : unit -> unitPublic Overrides Sub SuspendBinding ()Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de SuspendBinding methode gebruikt.
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
Opmerkingen
De SuspendBinding en ResumeBinding methoden maken het tijdelijk opschorten en hervatten van gegevensbinding mogelijk in een eenvoudig bindingsscenario. Normaal gesproken onderbreekt u de gegevensbinding als de gebruiker meerdere wijzigingen moet aanbrengen in gegevensvelden voordat de validatie plaatsvindt. Als bijvoorbeeld één veld moet worden gewijzigd in overeenstemming met een tweede, maar wanneer het valideren van het eerste veld ertoe zou leiden dat het tweede veld fout treedt.
Note
SuspendBinding voorkomt dat wijzigingen worden toegepast op de gegevensbron totdat ResumeBinding ze worden aangeroepen, maar verhindert niet dat er gebeurtenissen optreden. Besturingselementen die gebruikmaken van complexe gegevensbinding, zoals het DataGridView besturingselement, werken hun waarden bij op basis van wijzigingsevenementen, zoals de ListChanged gebeurtenis. Het aanroepen SuspendBinding voorkomt daarom niet dat complexe besturingselementen gebeurtenissen ontvangen om de gegevensbron bij te werken.
SuspendBinding
ResumeBinding Daarom zijn ze ontworpen voor gebruik met eenvoudige besturingselementen, zoals het TextBox besturingselement. U kunt deze methoden ook gebruiken in een complex bindingsscenario als u gebeurtenissen onderdrukt ListChanged door de RaiseListChangedEvents eigenschap in te stellen op false.