DependencyProperty.RegisterAttached Méthode

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType);

static member RegisterAttached : string * Type * Type -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type) As DependencyProperty

Paramètres

Retours

DependencyProperty

Identificateur de propriété de dépendance qui doit être utilisé pour définir la valeur d’un champ public static readonly dans votre classe. Cet identificateur est ensuite utilisé pour faire référence ultérieurement à la propriété de dépendance, pour des opérations comme la définition de sa valeur par programmation ou l’obtention de métadonnées.

Exemples

L’exemple suivant inscrit une propriété jointe sur une classe abstraite à l’aide de cette RegisterAttached signature.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Remarques

Une propriété jointe est un concept de propriété défini par xaml (Extensible Application Markup Language). WPF implémente les propriétés jointes en tant que propriétés de dépendance. Étant donné que les propriétés jointes WPF sont des propriétés de dépendance, elles peuvent avoir des métadonnées appliquées qui peuvent être utilisées par le système de propriétés général pour les opérations telles que les caractéristiques de disposition de rapport. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.

Pour plus d’informations sur l’inscription des propriétés de dépendance, consultez DependencyProperty.

Voir aussi

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata);

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyProperty

Paramètres

Retours

DependencyProperty

Identificateur de propriété de dépendance qui doit être utilisé pour définir la valeur d’un champ public static readonly dans votre classe. Cet identificateur est ensuite utilisé pour faire référence ultérieurement à la propriété de dépendance, pour des opérations comme la définition de sa valeur par programmation ou l’obtention de métadonnées.

Remarques

Une propriété jointe est un concept de propriété défini par xaml (Extensible Application Markup Language). WPF implémente les propriétés jointes en tant que propriétés de dépendance. Étant donné que les propriétés jointes WPF sont des propriétés de dépendance, elles peuvent avoir des métadonnées appliquées qui peuvent être utilisées par le système de propriétés général pour les opérations telles que les caractéristiques de disposition de rapport. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.

Pour plus d’informations sur l’inscription des propriétés de dépendance, consultez DependencyProperty.

Utiliser RegisterAttached pour les propriétés de dépendance héritées de valeur

Un scénario particulier pour l’inscription d’une propriété RegisterAttached de dépendance à la place consiste à prendre en charge l’héritage des valeurs de Register propriété. Vous devez inscrire des propriétés de dépendance héritées de valeur avec RegisterAttached même si la classe définit des accesseurs de wrapper de propriété qui exposent la propriété de dépendance, et même si vous n’envisagez pas d’exposer les méthodes statiques Get* et Set* pour fournir des accesseurs de prise en charge des propriétés jointes vraies. Bien que l’héritage des valeurs de propriété semble fonctionner pour les propriétés de dépendance non attachées, le comportement d’héritage d’une propriété non attachée par le biais de certaines limites d’élément dans l’arborescence d’exécution n’est pas défini. L’inscription de la propriété comme attachée fait en effet de la propriété jointe une propriété globale au système de propriétés et garantit que l’héritage des valeurs de propriété fonctionne sur toutes les limites d’une arborescence d’éléments. RegisterAttached Utilisez toujours pour inscrire les propriétés dans lesquelles vous spécifiez Inherits les métadonnées. Pour plus d’informations, consultez Héritage de valeur de propriété.

Voir aussi

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

public:
 static System::Windows::DependencyProperty ^ RegisterAttached(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);

public static System.Windows.DependencyProperty RegisterAttached (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata, System.Windows.ValidateValueCallback validateValueCallback);

static member RegisterAttached : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyProperty

Public Shared Function RegisterAttached (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyProperty

Paramètres

Retours

DependencyProperty

Identificateur de propriété de dépendance qui doit être utilisé pour définir la valeur d’un champ public static readonly dans votre classe. Cet identificateur est ensuite utilisé pour faire référence ultérieurement à la propriété de dépendance, pour des opérations comme la définition de sa valeur par programmation ou l’obtention de métadonnées.

Exemples

L’exemple suivant inscrit une propriété jointe sur une classe abstraite à l’aide de cette RegisterAttached signature. Cette propriété jointe est une propriété de type énumération, et l’inscription ajoute un rappel de validation pour vérifier que la valeur fournie est une valeur de l’énumération.

public static readonly DependencyProperty IsBubbleSourceProperty = DependencyProperty.RegisterAttached(
  "IsBubbleSource",
  typeof(Boolean),
  typeof(AquariumObject2)
);
public static void SetIsBubbleSource(UIElement element, Boolean value)
{
    element.SetValue(IsBubbleSourceProperty, value);
}
public static Boolean GetIsBubbleSource(UIElement element)
{
    return (Boolean)element.GetValue(IsBubbleSourceProperty);
}

Public Shared ReadOnly IsBubbleSourceProperty As DependencyProperty = DependencyProperty.RegisterAttached("IsBubbleSource", GetType(Boolean), GetType(AquariumObject2))
Public Shared Sub SetIsBubbleSource(ByVal element As UIElement, ByVal value As Boolean)
    element.SetValue(IsBubbleSourceProperty, value)
End Sub
Public Shared Function GetIsBubbleSource(ByVal element As UIElement) As Boolean
    Return CType(element.GetValue(IsBubbleSourceProperty), Boolean)
End Function

Remarques

Une propriété jointe est un concept de propriété défini par xaml (Extensible Application Markup Language). WPF implémente les propriétés jointes en tant que propriétés de dépendance. Étant donné que les propriétés jointes WPF sont des propriétés de dépendance, elles peuvent avoir des métadonnées appliquées qui peuvent être utilisées par le système de propriétés général pour les opérations telles que les caractéristiques de disposition de rapport. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.

Pour plus d’informations sur l’inscription des propriétés de dépendance, consultez DependencyProperty.

Utiliser RegisterAttached pour les propriétés de dépendance héritées de valeur

Un scénario particulier pour l’inscription d’une propriété RegisterAttached de dépendance à la place consiste à prendre en charge l’héritage des valeurs de Register propriété. Vous devez inscrire des propriétés de dépendance héritées de valeur avec RegisterAttached même si la classe définit des accesseurs de wrapper de propriété qui exposent la propriété de dépendance, et même si vous n’envisagez pas d’exposer les méthodes statiques Get* et Set* pour fournir des accesseurs de prise en charge des propriétés jointes vraies. Bien que l’héritage des valeurs de propriété semble fonctionner pour les propriétés de dépendance non attachées, le comportement d’héritage d’une propriété non attachée par le biais de certaines limites d’élément dans l’arborescence d’exécution n’est pas défini. L’inscription de la propriété comme attachée fait en effet de la propriété jointe une propriété globale au système de propriétés et garantit que l’héritage des valeurs de propriété fonctionne sur toutes les limites d’une arborescence d’éléments. RegisterAttached Utilisez toujours pour inscrire les propriétés dans lesquelles vous spécifiez Inherits les métadonnées. Pour plus d’informations, consultez Héritage de valeur de propriété.

Voir aussi

• Register(String, Type, Type, PropertyMetadata)
• RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)