Binding Klas

Definitie

Naamruimte:
System.Windows.Data
Assembly:
PresentationFramework.dll

Biedt toegang op hoog niveau tot de definitie van een binding, waarmee de eigenschappen van bindingsdoelobjecten (meestal WPF elementen) en elke gegevensbron (bijvoorbeeld een database, een XML-bestand of een object met gegevens) worden verbonden.

public ref class Binding : System::Windows::Data::BindingBase
public class Binding : System.Windows.Data.BindingBase
type Binding = class
    inherit BindingBase
Public Class Binding
Inherits BindingBase
Overname
Object
MarkupExtension
BindingBase
Binding

Opmerkingen

Windows Presentation Foundation -gegevensbinding (WPF) biedt een eenvoudige en consistente manier voor toepassingen om gegevens te presenteren en ermee te communiceren. Met gegevensbinding kunt u de waarden van de eigenschappen van twee verschillende objecten synchroniseren.

Als u een binding wilt maken, gebruikt u de Binding klasse of een van de andere klassen die overnemen BindingBase. Ongeacht het object dat u bindt en de aard van uw gegevensbron, volgt elke binding het model dat wordt geïllustreerd door de volgende afbeelding.

Diagram met basisgegevensbinding

In de afbeelding ziet u de volgende fundamentele WPF concepten voor gegevensbinding.

  • Elke binding heeft doorgaans deze vier onderdelen: een bindingsdoelobject, een doeleigenschap, een bindingsbron en een Path waarde in de bindingsbron die moet worden gebruikt. Als u bijvoorbeeld de inhoud van een TextBox object Naam wilt binden aan de eigenschap Naam van een object Werknemer, is het doelobject de TextBoxeigenschap , de doeleigenschap de Text eigenschap, de te gebruiken waarde naam en het bronobject het object Werknemer.

  • De doeleigenschap moet een afhankelijkheidseigenschap zijn. Dit betekent ook dat u een veld niet kunt binden. De meeste eigenschappen van UIElement objecten zijn afhankelijkheidseigenschappen en de meeste afhankelijkheidseigenschappen, behalve alleen-lezen eigenschappen, ondersteunen standaard gegevensbinding. (Alleen DependencyObject typen kunnen afhankelijkheidseigenschappen definiëren en alle UIElement objecten die zijn afgeleid van DependencyObject.)

  • Hoewel dit niet is opgegeven in de afbeelding, moet worden opgemerkt dat het bindingsbronobject niet beperkt is tot een aangepast CLR-object. WPF gegevensbinding ondersteunt gegevens in de vorm van CLR-objecten en XML. Als u enkele voorbeelden wilt opgeven, kan uw bindingsbron een UIElement zijn, een lijstobject, een CLR-object dat is gekoppeld aan ADO.NET-gegevens of webservices, of een XmlNode die uw XML-gegevens bevat.

Gebruik de Mode eigenschap om de richting van de gegevensstroom op te geven. Als u bronwijzigingen in eenrichtings- of tweerichtingsbindingen wilt detecteren, moet de bron een geschikt meldingsmechanisme voor eigenschappenwijzigingen implementeren, zoals INotifyPropertyChanged. Zie Voor een voorbeeld : Melding over het wijzigen van eigenschappen implementeren. De UpdateSourceTrigger eigenschap geeft de timing van bronupdates op. Zie 'Basisconcepten voor gegevensbinding' in het overzicht van gegevensbindingen voor meer informatie.

XAML-kenmerkgebruik

<object property="{Binding  declaration}"/>

XAML-waarden

Verklaring Nul of meer kenmerktoewijzingsclausules gescheiden door komma's (,). Zie Overzicht van bindingsmarkeringen of bindingsdeclaraties voor meer informatie.

Constructors

Name Description
Binding()

Initialiseert een nieuw exemplaar van de Binding klasse.
Binding(String)

Initialiseert een nieuw exemplaar van de Binding klasse met een eerste pad.

Velden

Name Description
DoNothing

Wordt gebruikt als een geretourneerde waarde om de bindingsengine te instrueren om geen actie uit te voeren.
IndexerName

Wordt gebruikt om PropertyNamePropertyChangedEventArgs aan te geven dat een indexeerfunctieeigenschap is gewijzigd.
SourceUpdatedEvent

Identificeert de SourceUpdated gekoppelde gebeurtenis.
TargetUpdatedEvent

Identificeert de TargetUpdated gekoppelde gebeurtenis.
XmlNamespaceManagerProperty

Identificeert de XmlNamespaceManager gekoppelde eigenschap.

Eigenschappen

Name Description
AsyncState

Hiermee worden ondoorzichtige gegevens opgehaald of ingesteld die worden doorgegeven aan de asynchrone gegevenszender.
BindingGroupName

Hiermee haalt u de naam op van de BindingGroup binding waartoe deze binding behoort.

(Overgenomen van BindingBase)
BindsDirectlyToSource

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de Path relatieve waarde moet worden geëvalueerd ten opzichte van het gegevensitem of het DataSourceProvider object.
Converter

Hiermee haalt u het conversieprogramma op of stelt u dit in.
ConverterCulture

Hiermee haalt u de cultuur op waarin het conversieprogramma moet worden geëvalueerd of ingesteld.
ConverterParameter

Hiermee haalt u de parameter op die moet worden doorgegeven aan de Converterparameter.
Delay

Hiermee wordt de hoeveelheid tijd in milliseconden opgehaald of ingesteld om te wachten voordat de bindingsbron wordt bijgewerkt nadat de waarde op het doel is gewijzigd.

(Overgenomen van BindingBase)
ElementName

Hiermee wordt de naam van het element opgehaald of ingesteld dat moet worden gebruikt als het bindingsbronobject.
FallbackValue

Hiermee wordt de waarde opgehaald of ingesteld die moet worden gebruikt wanneer de binding geen waarde kan retourneren.

(Overgenomen van BindingBase)
IsAsync

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de Binding waarden asynchroon moeten worden opgehaald en ingesteld.
Mode

Hiermee wordt een waarde opgehaald of ingesteld die de richting van de gegevensstroom in de binding aangeeft.
NotifyOnSourceUpdated

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de SourceUpdated gebeurtenis moet worden gegenereerd wanneer een waarde wordt overgedragen van het bindingsdoel naar de bindingsbron.
NotifyOnTargetUpdated

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de TargetUpdated gebeurtenis moet worden gegenereerd wanneer een waarde wordt overgebracht van de bindingsbron naar het bindingsdoel.
NotifyOnValidationError

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de Error gekoppelde gebeurtenis voor het afhankelijke object moet worden gegenereerd.
Path

Hiermee haalt u het pad op of stelt u het pad in op de eigenschap bindingsbron.
RelativeSource

Hiermee haalt u de bindingsbron op of stelt u deze in door de locatie op te geven ten opzichte van de positie van het bindingsdoel.
Source

Hiermee wordt het object opgehaald of ingesteld voor gebruik als bindingsbron.
StringFormat

Hiermee wordt een tekenreeks opgehaald of ingesteld die aangeeft hoe de binding moet worden opgemaakt als de afhankelijke waarde als een tekenreeks wordt weergegeven.

(Overgenomen van BindingBase)
TargetNullValue

Hiermee haalt u de waarde op die in het doel wordt gebruikt of stelt u deze in wanneer de waarde van de bron is null.

(Overgenomen van BindingBase)
UpdateSourceExceptionFilter

Hiermee haalt u een handler op die u kunt gebruiken om aangepaste logica te bieden voor het afhandelen van uitzonderingen die de bindingengine tegenkomt tijdens de update van de bindingsbronwaarde. Dit is alleen van toepassing als u een ExceptionValidationRule binding hebt gekoppeld.
UpdateSourceTrigger

Hiermee wordt een waarde opgehaald of ingesteld waarmee de timing van bindingsbronupdates wordt bepaald.
ValidatesOnDataErrors

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de DataErrorValidationRulewaarde moet worden opgenomen.
ValidatesOnExceptions

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de ExceptionValidationRulewaarde moet worden opgenomen.
ValidatesOnNotifyDataErrors

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de NotifyDataErrorValidationRulewaarde moet worden opgenomen.
ValidationRules

Hiermee haalt u een verzameling regels op waarmee de geldigheid van de gebruikersinvoer wordt gecontroleerd.
XPath

Hiermee wordt een XPath query opgehaald of ingesteld die de waarde op de XML-bindingsbron retourneert die moet worden gebruikt.

Toegevoegde eigenschappen

Name Description
XmlNamespaceManager

Hiermee worden de XmlNamespaceManager gebruikte query's opgehaald of ingesteld voor het uitvoeren van naamruimtebewuste XPath query's in XML-bindingen.

Methoden

Name Description
AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Hiermee voegt u een handler toe voor de SourceUpdated gekoppelde gebeurtenis.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Hiermee voegt u een handler toe voor de TargetUpdated gekoppelde gebeurtenis.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
GetXmlNamespaceManager(DependencyObject)

Retourneert een XML-naamruimtebeheerobject dat wordt gebruikt door de binding die is gekoppeld aan het opgegeven object.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ProvideValue(IServiceProvider)

Retourneert een object dat moet worden ingesteld op de eigenschap waarop deze binding en extensie worden toegepast.

(Overgenomen van BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Hiermee verwijdert u een handler voor de SourceUpdated gekoppelde gebeurtenis.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Hiermee verwijdert u een handler voor de TargetUpdated gekoppelde gebeurtenis.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Hiermee stelt u een naamruimtebeheerobject in dat wordt gebruikt door de binding die is gekoppeld aan het opgegeven element.
ShouldSerializeFallbackValue()

Retourneert een waarde die aangeeft of serialisatieprocessen de effectieve waarde van de FallbackValue eigenschap moeten serialiseren op exemplaren van deze klasse.

(Overgenomen van BindingBase)
ShouldSerializePath()

Hiermee wordt aangegeven of de Path eigenschap moet worden behouden.
ShouldSerializeSource()

Hiermee wordt aangegeven of de Source eigenschap moet worden behouden.
ShouldSerializeTargetNullValue()

Retourneert een waarde die aangeeft of de TargetNullValue eigenschap moet worden geserialiseerd.

(Overgenomen van BindingBase)
ShouldSerializeValidationRules()

Hiermee wordt aangegeven of de ValidationRules eigenschap moet worden behouden.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Toegevoegde gebeurtenissen

Name Description
SourceUpdated

Treedt op wanneer een waarde wordt overgedragen van het bindingsdoel naar de bindingsbron, maar alleen voor bindingen waarop de NotifyOnSourceUpdated waarde is ingesteld true.
TargetUpdated

Treedt op wanneer een waarde wordt overgebracht van de bindingsbron naar het bindingsdoel, maar alleen voor bindingen met de NotifyOnTargetUpdated waarde ingesteld op true.

Van toepassing op

Zie ook