FrameworkPropertyMetadata.IsNotDataBindable Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui indique si la propriété de dépendance prend en charge la liaison de données.
public:
property bool IsNotDataBindable { bool get(); void set(bool value); };public bool IsNotDataBindable { get; set; }member this.IsNotDataBindable : bool with get, setPublic Property IsNotDataBindable As BooleanValeur de propriété
true si la propriété ne prend pas en charge la liaison de données ; sinon, false. La valeur par défaut est false.
Exceptions
Les métadonnées ont déjà été appliquées à une opération de propriété de dépendance : elles sont donc sealed et les propriétés des métadonnées ne peuvent pas être définies.
Remarques
Notez que cette propriété de métadonnées est définie true spécifiquement pour les propriétés qui ne doivent pas prendre en charge la liaison de données, malgré les propriétés en lecture-écriture. L’attente est que dans la plupart des cas où une propriété de dépendance est déclarée, la liaison de données est souhaitée, car la liaison de données est l’un des principaux scénarios où une propriété de dépendance est utile. Contrairement BindsTwoWayByDefaultà ce qui suit, cela ne modifie pas simplement une valeur par défaut qui peut être modifiée ultérieurement sur une liaison spécifique. La définition de cette propriété dans les métadonnées d’une propriété true de dépendance désactive toutes les liaisons d’application de leurs valeurs par le biais d’expressions à cette propriété de dépendance.
Les propriétés de dépendance en lecture seule ne prennent pas en charge la liaison de données (car elles n’ont pas de setter qui peut appliquer des valeurs modifiées), mais ne sont toujours pas indiquées false pour IsNotDataBindable. Cela est dû au fait que les propriétés qui correspondent à une FrameworkPropertyMetadataOptions valeur signalent la parité avec la façon dont les métadonnées ont été établies, plutôt que de signaler toujours le comportement de résultat final que le nommage de la propriété peut impliquer. Pour déterminer si une propriété de dépendance donnée autorise la liaison de données, vous devez généralement vérifier IsDataBindingAllowed à la place. IsDataBindingAllowed est une commodité pour vérifier à la fois ReadOnly et IsNotDataBindable en tant qu’opération unique, ce qui génère le résultat attendu.
Les propriétés sur les classes dérivées de PropertyMetadata sont généralement définies dans le modèle objet comme en lecture-écriture. C’est pourquoi ils peuvent être ajustés après l’initialisation de l’instance. Toutefois, une fois les métadonnées consommées dans le cadre d’un appel à Register, AddOwnerou , le OverrideMetadatasystème de propriétés scellera cette instance de métadonnées et les propriétés qui transmettent les spécificités des métadonnées sont désormais considérées comme immuables. La tentative de définition de cette propriété après IsSealed avoir true été effectuée sur cette instance de métadonnées déclenche une exception.
Utilisation du texte XAML
Les membres de cette classe ne sont généralement pas utilisés en XAML.