Binding.Source Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Data

Obtient ou définit la source de données de la liaison.

public:
 property Platform::Object ^ Source { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable Source();

void Source(IInspectable value);

public object Source { get; set; }

var object = binding.source;
binding.source = object;

Public Property Source As Object

<Binding Source="sourceReference"/>

Valeur de propriété

Object

Platform::Object

IInspectable

Objet source qui contient les données de la liaison.

Exemples

L’exemple de code suivant montre comment définir cette propriété en XAML. Pour obtenir la liste complète du code, consultez l’exemple de liaison de données XAML.

<StackPanel>

  <StackPanel.Resources>
    <CollectionViewSource x:Name="teamsCVS"/>
  </StackPanel.Resources>

  <ListBox x:Name="lbTeams" Height="200" 
    ItemsSource="{Binding Source={StaticResource teamsCVS}}">
    <ListBox.ItemTemplate>
      <DataTemplate><!-- ... --></DataTemplate>
    </ListBox.ItemTemplate>
  </ListBox>

</StackPanel>

Pour obtenir un exemple montrant comment définir cette propriété dans le code, consultez la classe Binding .

Remarques

La propriété Source est facultative sur un objet Binding . Si la propriété Source est définie sur un objet Binding , la source de données s’applique uniquement aux propriétés cibles qui utilisent cet objet Binding .

Pour créer une source de données héritée par tous les éléments enfants de l’arborescence, définissez plutôt la propriété DataContext sur l’élément parent. Ensuite, l’élément parent et tous ses enfants recherchent dataContext comme source de leurs liaisons. Si la source est définie pour un élément enfant, elle remplace l’héritage DataContext dans cette instance.

La cible peut être liée directement à l’objet Source si le chemin d’accès est vide ou à une propriété de l’objet Source tel que défini par le chemin d’accès. Le chemin d’accès est défini en XAML avec la syntaxe de liaison ou lors de la création de l’objet Binding .

Vous ne pouvez pas définir les valeurs de propriété d’un objet Binding après que cette liaison a été attachée à un élément cible et à une propriété cible. Si vous tentez cette opération, vous obtiendrez une exception d’exécution.

Voir aussi

• Exemple de liaison de données XAML
• Présentation détaillée de la liaison de données