Partager via

DependencyProperty.RegisterAttached Méthode

  • Référence

Définition

Espace de noms:
System.Windows
Assembly:
WindowsBase.dll

Inscrit une propriété jointe avec le système de propriétés.

Surcharges

RegisterAttached(String, Type, Type)

Inscrit une propriété jointe avec le nom de propriété, le type de propriété et le type de propriétaire spécifiés.
RegisterAttached(String, Type, Type, PropertyMetadata)

Inscrit une propriété jointe avec le nom de propriété, le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Inscrit une propriété jointe avec le type de propriété, le type de propriétaire, les métadonnées de propriété et le rappel de validation de valeur spécifiés pour la propriété.

RegisterAttached(String, Type, Type)

Inscrit une propriété jointe avec le nom de propriété, le type de propriété et le type de propriétaire spécifiés.

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

name
String

Nom de la propriété de dépendance à inscrire.

propertyType
Type

Type de la propriété.

ownerType
Type

Type du propriétaire qui inscrit la propriété de dépendance.

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

S’applique à

RegisterAttached(String, Type, Type, PropertyMetadata)

Inscrit une propriété jointe avec le nom de propriété, le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés.

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

name
String

Nom de la propriété de dépendance à inscrire.

propertyType
Type

Type de la propriété.

ownerType
Type

Type du propriétaire qui inscrit la propriété de dépendance.

defaultMetadata
PropertyMetadata

Métadonnées de propriété pour la propriété de dépendance. Cela peut inclure la valeur par défaut, ainsi que d’autres caractéristiques.

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

S’applique à

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Inscrit une propriété jointe avec le type de propriété, le type de propriétaire, les métadonnées de propriété et le rappel de validation de valeur spécifiés pour la propriété.

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

name
String

Nom de la propriété de dépendance à inscrire.

propertyType
Type

Type de la propriété.

ownerType
Type

Type du propriétaire qui inscrit la propriété de dépendance.

defaultMetadata
PropertyMetadata

Métadonnées de propriété pour la propriété de dépendance. Cela peut inclure la valeur par défaut, ainsi que d’autres caractéristiques.

validateValueCallback
ValidateValueCallback

Référence à un rappel qui doit exécuter toute validation personnalisée de la valeur de propriété de dépendance au-delà de la validation de type standard.

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

S’applique à