Binding Binding Binding Binding Class

Définition

Fournit un accès de haut niveau à la définition d’une liaison, qui connecte les propriétés d’objets cible de liaison (en général, des éléments WPF) et d’une source de données quelconque (par exemple, une base de données, un fichier XML ou tout objet contenant des données).Provides high-level access to the definition of a binding, which connects the properties of binding target objects (typically, WPF elements), and any data source (for example, a database, an XML file, or any object that contains data).

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
Héritage

Remarques

La liaison de données Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) offre un moyen simple et cohérent pour les applications de présenter les données et d’interagir avec elles.Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) data binding provides a simple and consistent way for applications to present and interact with data. La liaison de données vous permet de synchroniser les valeurs des propriétés de deux objets différents.Data binding enables you to synchronize the values of the properties of two different objects.

Pour établir une liaison, utilisez la Binding classe ou l’une des autres classes qui héritent BindingBasede.To establish a binding, use the Binding class or one of the other classes that inherit BindingBase. Quel que soit l’objet que vous liez et la nature de votre source de données, chaque liaison suit le modèle illustré par la figure suivante.Regardless of what object you are binding and the nature of your data source, each binding follows the model illustrated by the following figure.

Diagramme de liaison de données de baseBasic data binding diagram

La figure illustre les concepts fondamentaux WPFWPF de liaison de données suivants.The figure demonstrates the following fundamental WPFWPF data binding concepts.

  • En général, chaque liaison a ces quatre composants: un objet cible de liaison, une propriété cible, une source de Path liaison et un à la valeur de la source de liaison à utiliser.Each binding typically has these four components: a binding target object, a target property, a binding source, and a Path to the value in the binding source to use. Par exemple, si vous souhaitez lier le contenu d’un TextBox à la propriété Name d’un objet Employee, votre objet Target est le TextBox, la propriété Target est la Text propriété, la valeur à utiliser est Name et l’objet source est l’employé dessin.For example, if you want to bind the content of a TextBox to the Name property of an Employee object, your target object is the TextBox, the target property is the Text property, the value to use is Name, and the source object is the Employee object.

  • La propriété cible doit être une propriété de dépendance.The target property must be a dependency property. Cela signifie également que vous ne pouvez pas lier un champ.This also means that you cannot bind a field. La plupart des UIElement propriétés d’objets sont des propriétés de dépendance et la plupart des propriétés de dépendance, à l’exception de celles en lecture seule, prennent en charge la liaison de données par défaut.Most properties of UIElement objects are dependency properties and most dependency properties, except read-only ones, support data binding by default. (Seuls DependencyObject les types peuvent définir des propriétés de UIElement dépendance et tous DependencyObjectles objets dérivent de.)(Only DependencyObject types can define dependency properties and all UIElement objects derive from DependencyObject.)

  • Bien que cela n’est pas spécifié sur l’illustration, il convient de noter que l’objet de source de liaison n’est pas limité à un objet CLRCLR personnalisé.Although not specified in the figure, it should be noted that the binding source object is not restricted to being a custom CLRCLR object. La liaison de données WPFWPF prend en charge les données sous forme d’objets CLRCLR et XMLXML.WPFWPF data binding supports data in the form of CLRCLR objects and XMLXML. Pour fournir quelques exemples, votre source de liaison peut être UIElementun, n’importe quel objet CLRCLR de liste, un objet ADO.NETADO.NET associé à des données ou des services Web, ou un XMLXML XMLNode qui contient vos données.To provide some examples, your binding source may be a UIElement, any list object, a CLRCLR object that is associated with ADO.NETADO.NET data or Web Services, or an XmlNode that contains your XMLXML data.

Utilisez la Mode propriété pour spécifier la direction du Workflow.Use the Mode property to specify the direction of the data flow. Pour détecter les modifications de source dans des liaisons unidirectionnelles ou bidirectionnelles, la source doit implémenter un mécanisme de notification de INotifyPropertyChangedmodification de propriété approprié, tel que.To detect source changes in one-way or two-way bindings, the source must implement a suitable property change notification mechanism such as INotifyPropertyChanged. Pour voir un exemple, consultez Comment : Implémenter la notificationde modification de propriété.For an example, see How to: Implement Property Change Notification. La UpdateSourceTrigger propriété spécifie le minutage des mises à jour de la source.The UpdateSourceTrigger property specifies the timing of source updates. Pour plus d’informations, consultez «concepts de base de la liaison de données» dans vue d’ensemblede la liaison de données.For more information, see "Basic Data Binding Concepts" in Data Binding Overview.

Utilisation d'attributs XAMLXAML Attribute Usage

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

Valeurs XAMLXAML Values

déclarationdeclaration
Zéro, une ou plusieurs clauses d’assignation d’attribut séparées par des virgules (,).Zero or more attribute-assignment clauses separated by commas (,). Pour plus d’informations, consultez vue d’ensemblede la liaison de balises ou des déclarations de liaison.For more information, see Binding Markup Extension or Binding Declarations Overview.

Constructeurs

Binding() Binding() Binding() Binding()

Initialise une nouvelle instance de la classe Binding.Initializes a new instance of the Binding class.

Binding(String) Binding(String) Binding(String) Binding(String)

Initialise une nouvelle instance de la classe Binding avec un chemin initial.Initializes a new instance of the Binding class with an initial path.

Champs

DoNothing DoNothing DoNothing DoNothing

Utilisé comme une valeur retournée pour indiquer au moteur de liaison de n’effectuer aucune action.Used as a returned value to instruct the binding engine not to perform any action.

IndexerName IndexerName IndexerName IndexerName

Utilisé comme PropertyName de PropertyChangedEventArgs pour indiquer qu'une propriété d'indexeur a changé.Used as the PropertyName of PropertyChangedEventArgs to indicate that an indexer property has changed.

SourceUpdatedEvent SourceUpdatedEvent SourceUpdatedEvent SourceUpdatedEvent

Identifie l’événement attaché SourceUpdated.Identifies the SourceUpdated attached event.

TargetUpdatedEvent TargetUpdatedEvent TargetUpdatedEvent TargetUpdatedEvent

Identifie l’événement attaché TargetUpdated.Identifies the TargetUpdated attached event.

XmlNamespaceManagerProperty XmlNamespaceManagerProperty XmlNamespaceManagerProperty XmlNamespaceManagerProperty

Identifie la propriété jointe XmlNamespaceManager.Identifies the XmlNamespaceManager attached property.

Propriétés

AsyncState AsyncState AsyncState AsyncState

Obtient ou définit les données opaques passées au répartiteur de données asynchrone.Gets or sets opaque data passed to the asynchronous data dispatcher.

BindingGroupName BindingGroupName BindingGroupName BindingGroupName

Obtient ou définit le nom du BindingGroup auquel appartient cette liaison.Gets or sets the name of the BindingGroup to which this binding belongs.

(Inherited from BindingBase)
BindsDirectlyToSource BindsDirectlyToSource BindsDirectlyToSource BindsDirectlyToSource

Obtient ou définit une valeur qui indique s’il faut évaluer Path par rapport à l’élément de données ou à l’objet DataSourceProvider.Gets or sets a value that indicates whether to evaluate the Path relative to the data item or the DataSourceProvider object.

Converter Converter Converter Converter

Obtient ou définit le convertisseur à utiliser.Gets or sets the converter to use.

ConverterCulture ConverterCulture ConverterCulture ConverterCulture

Obtient ou définit la culture dans laquelle évaluer le convertisseur.Gets or sets the culture in which to evaluate the converter.

ConverterParameter ConverterParameter ConverterParameter ConverterParameter

Obtient ou définit le paramètre à passer à Converter.Gets or sets the parameter to pass to the Converter.

Delay Delay Delay Delay

Obtient ou définit la durée d'attente, en millisecondes, avant de mettre à jour la source de liaison après le changement de la valeur sur les cibles.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Inherited from BindingBase)
ElementName ElementName ElementName ElementName

Obtient ou définit le nom de l’élément à utiliser comme objet source de liaison.Gets or sets the name of the element to use as the binding source object.

FallbackValue FallbackValue FallbackValue FallbackValue

Obtient ou définit la valeur à utiliser quand la liaison ne peut pas retourner une valeur.Gets or sets the value to use when the binding is unable to return a value.

(Inherited from BindingBase)
IsAsync IsAsync IsAsync IsAsync

Obtient ou définit une valeur qui indique si le Binding doit obtenir et définir des valeurs de façon asynchrone.Gets or sets a value that indicates whether the Binding should get and set values asynchronously.

Mode Mode Mode Mode

Obtient ou définit une valeur qui indique le sens du flux de données dans la liaison.Gets or sets a value that indicates the direction of the data flow in the binding.

NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated

Obtient ou définit une valeur qui indique s’il faut déclencher l’événement SourceUpdated quand une valeur est transférée de la cible de liaison vers la source de liaison.Gets or sets a value that indicates whether to raise the SourceUpdated event when a value is transferred from the binding target to the binding source.

NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated

Obtient ou définit une valeur qui indique s’il faut déclencher l’événement TargetUpdated quand une valeur est transférée de la source de liaison vers la cible de liaison.Gets or sets a value that indicates whether to raise the TargetUpdated event when a value is transferred from the binding source to the binding target.

NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError

Obtient ou définit une valeur qui indique s’il faut déclencher l’événement attaché Error sur l’objet lié.Gets or sets a value that indicates whether to raise the Error attached event on the bound object.

Path Path Path Path

Obtient ou définit le chemin de la propriété de source de liaison.Gets or sets the path to the binding source property.

RelativeSource RelativeSource RelativeSource RelativeSource

Obtient ou définit la source de liaison en spécifiant son emplacement par rapport à la position de la cible de liaison.Gets or sets the binding source by specifying its location relative to the position of the binding target.

Source Source Source Source

Obtient ou définit l’objet à utiliser comme source de liaison.Gets or sets the object to use as the binding source.

StringFormat StringFormat StringFormat StringFormat

Obtient ou définit une chaîne qui spécifie comment mettre en forme la liaison si elle affiche la valeur liée en tant que chaîne.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Inherited from BindingBase)
TargetNullValue TargetNullValue TargetNullValue TargetNullValue

Obtient ou définit la valeur utilisée dans la cible lorsque la valeur de la source est null.Gets or sets the value that is used in the target when the value of the source is null.

(Inherited from BindingBase)
UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter

Obtient ou définit un gestionnaire que vous pouvez utiliser pour fournir une logique personnalisée pour gérer les exceptions que le moteur de liaison rencontre pendant la mise à jour de la valeur source de liaison.Gets or sets a handler you can use to provide custom logic for handling exceptions that the binding engine encounters during the update of the binding source value. Cela s’applique uniquement si vous avez associé un ExceptionValidationRule à votre liaison.This is only applicable if you have associated an ExceptionValidationRule with your binding.

UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger

Obtient ou définit une valeur qui détermine la planification des mises à jour de la source de liaison.Gets or sets a value that determines the timing of binding source updates.

ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors

Obtient ou définit une valeur qui indique s'il faut inclure DataErrorValidationRule.Gets or sets a value that indicates whether to include the DataErrorValidationRule.

ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions

Obtient ou définit une valeur qui indique s'il faut inclure ExceptionValidationRule.Gets or sets a value that indicates whether to include the ExceptionValidationRule.

ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors

Obtient ou définit une valeur qui indique s'il faut inclure NotifyDataErrorValidationRule.Gets or sets a value that indicates whether to include the NotifyDataErrorValidationRule.

ValidationRules ValidationRules ValidationRules ValidationRules

Obtient une collection de règles qui vérifient la validité des entrées utilisateur.Gets a collection of rules that check the validity of the user input.

XPath XPath XPath XPath

Obtient ou définit une requête XPath qui retourne la valeur de la source de liaison XMLXML à utiliser.Gets or sets an XPath query that returns the value on the XMLXML binding source to use.

Propriétés attachées

XmlNamespaceManager XmlNamespaceManager XmlNamespaceManager XmlNamespaceManager

Obtient ou définit le XmlNamespaceManager utilisé pour effectuer des requêtes XPath tenant compte des espaces de noms dans des liaisons XML.Gets or sets the XmlNamespaceManager used to perform namespace-aware XPath queries in XML bindings.

Méthodes

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Ajoute un gestionnaire pour l'événement attaché SourceUpdated.Adds a handler for the SourceUpdated attached event.

AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Ajoute un gestionnaire pour l'événement attaché TargetUpdated.Adds a handler for the TargetUpdated attached event.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject)

Retourne un objet gestionnaire d’espaces de noms XMLXML utilisé par la liaison attachée à l’objet spécifié.Returns an XMLXML namespace manager object used by the binding attached to the specified object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider)

Retourne un objet qui doit être défini sur la propriété où cette liaison et cette extension sont appliquées.Returns an object that should be set on the property where this binding and extension are applied.

(Inherited from BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Supprime un gestionnaire pour l'événement attaché SourceUpdated.Removes a handler for the SourceUpdated attached event.

RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Supprime un gestionnaire pour l'événement attaché TargetUpdated.Removes a handler for the TargetUpdated attached event.

SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Définit un objet gestionnaire d’espace de noms utilisé par la liaison jointe à l’élément fourni.Sets a namespace manager object used by the binding attached to the provided element.

ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue()

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur effective de la propriété FallbackValue sur les instances de cette classe.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Inherited from BindingBase)
ShouldSerializePath() ShouldSerializePath() ShouldSerializePath() ShouldSerializePath()

Indique si la propriété Path doit être rendue persistante.Indicates whether the Path property should be persisted.

ShouldSerializeSource() ShouldSerializeSource() ShouldSerializeSource() ShouldSerializeSource()

Indique si la propriété Source doit être rendue persistante.Indicates whether the Source property should be persisted.

ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue()

Retourne une valeur qui indique si la propriété TargetNullValue doit être sérialisée.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Inherited from BindingBase)
ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules()

Indique si la propriété ValidationRules doit être rendue persistante.Indicates whether the ValidationRules property should be persisted.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements attachés

SourceUpdated SourceUpdated SourceUpdated SourceUpdated

Se produit quand une valeur est transférée de la cible de liaison vers la source de liaison, mais uniquement pour les liaisons dont la propriété NotifyOnSourceUpdated a la valeur true.Occurs when a value is transferred from the binding target to the binding source, but only for bindings with the NotifyOnSourceUpdated value set to true.

TargetUpdated TargetUpdated TargetUpdated TargetUpdated

Se produit quand une valeur est transférée de la source de liaison vers la cible de liaison, mais uniquement pour les liaisons dont la propriété NotifyOnTargetUpdated a la valeur true.Occurs when a value is transferred from the binding source to the binding target, but only for bindings with the NotifyOnTargetUpdated value set to true.

S’applique à

Voir aussi