Binding, classe

Liaison Class

Définit une liaison qui connecte les propriétés de cibles de la liaison et de sources de données.

Héritage

Object
  DependencyObject
    BindingBase
      Binding

Syntaxe


public class Binding : BindingBase


<dependencyobjectdependencyproperty="bindingString" />

XAML Values

bindingString

Chaîne d'extension de balisage {Binding}. La chaîne d'extension {Binding} peut également inclure un chemin d'accès et/ou une ou plusieurs paires de property=value qui définissent les propriétés de Binding via le comportement des extensions de balisage. Les propriétés suivantes peuvent être référencées et définies via une chaîne d'extension de balisage {Binding} : Converter, ConverterParameter, ElementName, Mode, Path, RelativeSource, Source.

Attributs

MarshalingBehaviorAttribute(Agile)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)
WebHostHiddenAttribute()

Membres

BindingClasse comporte les types de membres suivants :

Constructeurs

BindingClasse comporte les constructeurs suivants.

ConstructeurDescription
Binding Initializes a new instance of the Binding class.

 

Méthodes

The Binding Classe comporte les méthodes suivantes. Il hérite également des méthodes de Object Classe.

MéthodeDescription
ClearValue Clears the local value of a dependency property. (Hérité de DependencyObject)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Hérité de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Hérité de DependencyObject)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Hérité de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Hérité de DependencyObject)

 

Propriétés

Le BindingClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Converter

en lecture/écritureGets or sets the converter object that is called by the binding engine to modify the data as it is passed between the source and target, or vice versa.

ConverterLanguage

en lecture/écritureGets or sets a value that names the language to pass to any converter specified by the Converter property.

ConverterParameter

en lecture/écritureGets or sets a parameter that can be used in the Converter logic.

Dispatcher

en lecture seuleGets the CoreDispatcher that this object is associated with. (Hérité de DependencyObject)

ElementName

en lecture/écritureGets or sets the name of the element to use as the binding source for the Binding.

Mode

en lecture/écritureGets or sets a value that indicates the direction of the data flow in the binding.

Path

en lecture/écritureGets or sets the path to the binding source property.

RelativeSource

en lecture/écritureGets or sets the binding source by specifying its location relative to the position of the binding target.

Source

en lecture/écritureGets or sets the data source for the binding.

 

Remarques

L'extension de balisage Binding vous permet de spécifier une valeur Binding comme chaîne d'attribut unique, y compris la définition de propriétés Binding telles que Path et Source.

Un objet Binding connecte directement une propriété de dépendance d'un FrameworkElement à un objet de données de sorte que les mises à jour de l'objet de données soient automatiquement propagées à la propriété. La classe Binding définit les propriétés d'une liaison. Chaque liaison doit avoir un élément cible, une propriété cible et une source de données, bien que certaines valeurs soient fournies par défaut si vous ne les spécifiez pas.

Pour la liaison à une propriété ou une sous-propriété sur un objet de données, définissez la propriété Path de l'objet Binding.

Vous pouvez appliquer une instance d'une classe Binding à plusieurs cibles. Toutefois, vous ne pouvez pas modifier les valeurs de propriété d'un objet Binding après l'avoir joint à un élément cible.

Remarque  L'appel de la méthode FrameworkElement.SetBinding et la transmission d'un nouvel objet Binding ne suppriment pas nécessairement une liaison existante. À la place, vous devez utiliser la méthode DependencyObject.ClearValue.

Pour plus d'informations, consultez Vue d’ensemble de la liaison de données.

Exemples

L'exemple de code suivant montre comment créer une liaison en XAML. Pour la liste de codes complète, consultez l'Exemple de liaison de données.


<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. --> 
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

L'exemple de code suivant montre comment créer une liaison dans le code.


// Create the source string.
string s = "Hello";

// Create the binding description.
Binding b = new Binding();
b.Mode = BindingMode.OneTime;
b.Source = s;

// Attach the binding to the target.
MyText.SetBinding(TextBlock.TextProperty, b);


Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store uniquement]

Espace de noms

Windows.UI.Xaml.Data
Windows::UI::Xaml::Data [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple de liaison de données
Liaison de données avec XAML

 

 

Afficher:
© 2018 Microsoft