DependencyProperty, classe

Un DependencyProperty prend en charge les fonctions suivantes dans Windows Presentation Foundation (WPF) :

• La propriété peut être définie dans un style. Pour plus d'informations, consultez Application d'un style et création de modèles.

• La propriété peut être définie via la liaison de données. Pour plus d'informations sur les propriétés de dépendance de liaison de données, consultez Comment : lier les propriétés de deux contrôles.

• La propriété peut être définie avec une référence à une ressource dynamique. Pour plus d'informations, consultez Ressources XAML.

• La propriété peut hériter automatiquement sa valeur d'un élément parent de l'arborescence d'éléments. Pour plus d'informations, consultez Héritage de la valeur de propriété.

• La propriété peut être animée. Pour plus d'informations, consultez Vue d'ensemble de l'animation.

• La propriété peut signaler que la valeur précédente de la propriété a été modifiée et la valeur de propriété peut être forcée. Pour plus d'informations, consultez Validation et rappels de propriétés de dépendance.

• La propriété signale des informations à WPF, par exemple si la modification d'une valeur de propriété doit requérir que le système de disposition recompose les éléments visuels pour un élément.

• La propriété reçoit une prise en charge dans le Concepteur WPF pour Visual Studio. Par exemple, la propriété peut être modifiée dans la fenêtre Propriétés.

Pour en savoir plus sur les propriétés de dépendance, consultez Vue d'ensemble des propriétés de dépendance. Si vous souhaitez que les propriétés de vos types personnalisés prennent en charge les fonctions dans la liste précédente, vous devez créer une propriété de dépendance. Pour apprendre à créer des propriétés de dépendance personnalisées, consultez Propriétés de dépendance personnalisées.

Une propriété jointe est une propriété qui permet à tout objet de signaler les informations au type qui définit la propriété jointe. Dans WPF, tout type qui hérite de DependencyObject peut utiliser une propriété jointe que le type hérite ou non du type qui définit la propriété. Une propriété jointe est une fonctionnalité du langage XAML. Pour définir une propriété jointe dans XAML, utilisez la syntaxe TypePropritaire.NomPropriété. Un exemple de propriété jointe est la propriété DockPanel.Dock. Si vous souhaitez créer une propriété qui peut être utilisée sur tous les types DependencyObject, vous devez créer une propriété jointe. Pour en savoir plus sur les propriétés jointes, notamment comment les créer, consultez Vue d'ensemble des propriétés jointes.

Cet exemple montre comment stocker une propriété Common Language Runtime (CLR) avec un champ DependencyProperty et ainsi définir une propriété de dépendance. Lorsque vous définissez vos propres propriétés et voulez qu'elles prennent en charge de nombreux aspects des fonctionnalités Windows Presentation Foundation (WPF), telles que les styles, la liaison de données, l'héritage, l'animation et les valeurs par défaut, vous devez les implémenter en tant que propriétés de dépendance.

L'exemple suivant enregistre tout d'abord une propriété de dépendance en appelant la méthode Register. Le nom du champ d'identificateur que vous utilisez pour stocker le nom et les caractéristiques de la propriété de dépendance doit être Name que vous avez choisi pour la propriété de dépendance dans le cadre de l'appel Register, ajouté par la chaîne littérale Property. Par exemple, si vous enregistrez une propriété de dépendance avec un Name de Location, le champ d'identificateur que vous définissez pour la propriété de dépendance doit être appelé LocationProperty.

Dans cet exemple, le nom de la propriété de dépendance et de son accesseur CLR est State, le champ d'identificateur est StateProperty, le type de la propriété est Boolean et le type qui enregistre la propriété de dépendance est MyStateControl.

Si vous ne suivez pas ce modèle d'affectation de noms, les concepteurs risquent de ne pas signaler votre propriété correctement, tandis que certains aspects de l'application du style du système de propriétés pourraient avoir un comportement inattendu.

Vous pouvez également spécifier des métadonnées par défaut pour une propriété de dépendance. Cet exemple enregistre la valeur par défaut false pour la propriété de dépendance State.

public class MyStateControl : ButtonBase
{
  public MyStateControl() : base() { }
  public Boolean State
  {
    get { return (Boolean)this.GetValue(StateProperty); }
    set { this.SetValue(StateProperty, value); } 
  }
  public static readonly DependencyProperty StateProperty = DependencyProperty.Register(
    "State", typeof(Boolean), typeof(MyStateControl),new PropertyMetadata(false));
}

Pour plus d'informations sur l'implémentation d'une propriété de dépendance et les raisons de cette implémentation, par opposition au simple stockage d'une propriété CLR par un champ privé, consultez Vue d'ensemble des propriétés de dépendance.

.NET Framework

.NET Framework Client Profile

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)

Référence

Autres ressources