Binding Classe

Définition

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Binding : BindingBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Binding : BindingBase

Public Class Binding
Inherits BindingBase

<Binding .../>
- or -
<dependencyobject dependencyproperty="{Binding bindingArgs}" />

Héritage

Object IInspectable DependencyObject BindingBase Binding

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Exemples

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

<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.
TextBlock MyText = new TextBlock();
MyText.SetBinding(TextBlock.TextProperty, b);

// Create the source string.
String^ s = ref new String(L"Hello");

// Create the binding description.
Binding^ b = ref new Binding();
b->Mode = BindingMode::OneTime;
b->Source = s;

// Attach the binding to the target.
TextBlock^ MyText = ref new TextBlock();
MyText->SetBinding(MyText->TextProperty, b);

'Create the source string 
Dim s As String = "Hello"

'Create the binding description 
Dim b As New Binding()
b.Mode = BindingMode.OneTime
b.Source = s

'Attach the binding to the target 
Dim MyText As New TextBlock()
MyText.SetBinding(TextBlock.TextProperty, b)

Remarques

L’extension de balisage {Binding} vous permet de spécifier une valeur de liaison sous la forme d’une chaîne d’attribut unique en XAML, y compris la définition de propriétés de liaison telles que Path et Source. Pour plus d’informations sur les concepts de liaison de données, consultez Liaison de données en détail.

La classe Binding peut être considérée comme l’exposition code-behind de l’extension de balisage {Binding}. Si une liaison est déjà appliquée à une cible (ce qui se produit lorsque le XAML est chargé), vous ne pouvez pas définir les propriétés en lecture-écriture d’un objet Binding pour modifier le comportement d’une liaison au moment de l’exécution. Toute liaison définie par XAML doit être considérée comme immuable. Toutefois, vous pouvez créer un objet Binding, définir ses propriétés et établir une nouvelle liaison sur une cible d’élément d’interface utilisateur spécifique à l’aide de FrameworkElement.SetBinding. Pour plus d’informations, consultez Création de liaisons dans le code.

Un objet Binding connecte une propriété de dépendance d’un FrameworkElement directement à un objet de données afin que les mises à jour de l’objet de données soient automatiquement propagées à la propriété qui utilise la liaison de données. 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 établir une 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. Pour plus d’informations sur la définition du chemin d’accès dans le code ou dans XAML, consultez Syntaxe du chemin de propriété ou extension de balisage {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 attaché à un élément cible.

Pour plus d’informations sur l’utilisation des attributs XAML pour les propriétés qui peuvent prendre une liaison ou qui peuvent autrement être définies sur une valeur liée aux données, consultez Extension de balisage {Binding}.

La propriété qui est la cible de la liaison de données doit être une propriété de dépendance. Pour plus d’informations, voir Vue d’ensemble des propriétés de dépendance.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• SetBinding(DependencyObject, DependencyProperty, BindingBase)
• Exemple de liaison de données XAML
• Présentation détaillée de la liaison de données
• Vue d’ensemble des propriétés de dépendance
• Syntaxe de Property-path