Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Binding.Mode, propriété

Obtient ou définit une valeur qui indique la direction du flux de données dans la liaison.

Espace de noms :  System.Windows.Data
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public BindingMode Mode { get; set; }
<object Mode="BindingMode" .../>

Valeur de propriété

Type : System.Windows.Data.BindingMode
L'une des valeurs BindingMode. La valeur par défaut est Default, qui retourne la valeur de mode de liaison par défaut de la propriété de dépendance cible. Cependant, la valeur par défaut varie d'une propriété de dépendance à l'autre. D'une manière générale, les propriétés de contrôle qui peuvent être modifiées par l'utilisateur, telles que celles des zones de texte et des cases à cocher, sont définies par défaut sur le type de liaison bidirectionnelle, tandis que la plupart des autres propriétés sont définies par défaut sur le type de liaison monodirectionnelle.
Vous pouvez déterminer par programmation si une propriété de dépendance effectue par défaut une liaison monodirectionnelle ou bidirectionnelle en obtenant les métadonnées de la propriété à l'aide de GetMetadata ; vérifiez ensuite la valeur booléenne de la propriété BindsTwoWayByDefault.

Pour prendre en charge des liaisons OneWay et TwoWay, les données sous-jacentes doivent implémenter INotifyPropertyChanged. Pour plus d'informations, consultez Comment : implémenter la notification des modifications de propriétés.

Pour les liaisons TwoWay ou OneWayToSource, vous pouvez contrôler les mises à jour de la cible vers la source en définissant la propriété UpdateSourceTrigger. Pour plus d'informations, consultez UpdateSourceTrigger.

Pour plus d'informations sur les différents modes de liaison, consultez Vue d'ensemble de la liaison de données.

Cet exemple indique comment spécifier si la liaison met uniquement à jour la propriété cible de liaison (cible), la propriété source de liaison (source), ou à la fois les propriétés cible et source.

Vous utilisez la propriété Mode pour spécifier le sens de la liaison. La liste d'énumération suivante affiche les options disponibles pour les mises à jour de liaison :

  • TwoWay met à jour la propriété cible ou la propriété à chaque fois que la propriété cible ou source est modifiée.

  • OneWay met à jour la propriété cible uniquement lorsque la propriété source est modifiée.

  • OneTime met à jour la propriété cible uniquement lorsque l'application démarre ou lorsque le DataContext subit une modification.

  • OneWayToSource met à jour la propriété source lorsque la propriété cible est modifiée.

  • Default entraîne l'utilisation de la valeur Mode par défaut de la propriété cible.

Pour plus d'informations, consultez l'énumération BindingMode.

L'exemple suivant montre comment définir la propriété Mode.


<TextBlock Name="IncomeText" Grid.Row="0" Grid.Column="1"
  Text="{Binding Path=TotalIncome, Mode=OneTime}"/>


Pour détecter des modifications de source (applicables aux liaisons OneWay et TwoWay), la source doit implémenter un mécanisme de notification des modifications de propriétés approprié tel que INotifyPropertyChanged. Consultez Comment : implémenter la notification des modifications de propriétés pour obtenir un exemple d'implémentation de INotifyPropertyChanged.

Pour les liaisons TwoWay ou OneWayToSource, vous pouvez contrôler le minutage des mises à jour de la source en définissant la propriété UpdateSourceTrigger. Pour plus d'informations, consultez UpdateSourceTrigger.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft