DependencyProperty.RegisterAttached Méthode

Définition

Inscrit une propriété jointe avec le système de propriétés.Registers an attached property with the property system.

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.Registers an attached property with the specified property name, property type, and owner type.

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.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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é.Registers an attached property with the specified property type, owner type, property metadata, and value validation callback for the property.

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.Registers an attached property with the specified property name, property type, and owner type.

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.The name of the dependency property to register.

propertyType
Type

Type de la propriété.The type of the property.

ownerType
Type

Type du propriétaire qui inscrit la propriété de dépendance.The owner type that is registering the dependency property.

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.A dependency property identifier that should be used to set the value of a public static readonly field in your class. 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.That identifier is then used to reference the dependency property later, for operations such as setting its value programmatically or obtaining metadata.

Exemples

L’exemple suivant inscrit une propriété jointe sur une classe abstraite à l’aide de cette RegisterAttached signature.The following example registers an attached property on an abstract class using this 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 langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML).An attached property is a property concept defined by langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML). WPFWPF implémente les propriétés jointes en tant que propriétés de dépendance.implements attached properties as dependency properties. Étant donné que les propriétés jointes WPFWPF 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 des opérations telles que la création de rapports sur les caractéristiques de la disposition.Because the WPFWPF attached properties are dependency properties, they can have metadata applied that can be used by the general property system for operations such as reporting layout characteristics. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.For more information, see Attached Properties Overview.

Pour plus d’informations sur l’inscription des propriétés de dépendance, consultez DependencyProperty.For more information on dependency property registration, see DependencyProperty.

Voir aussi

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.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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.The name of the dependency property to register.

propertyType
Type

Type de la propriété.The type of the property.

ownerType
Type

Type du propriétaire qui inscrit la propriété de dépendance.The owner type that is registering the dependency property.

defaultMetadata
PropertyMetadata

Métadonnées de propriété de la propriété de dépendance.Property metadata for the dependency property. Cela peut inclure la valeur par défaut, ainsi que d’autres caractéristiques.This can include the default value as well as other characteristics.

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.A dependency property identifier that should be used to set the value of a public static readonly field in your class. 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.That identifier is then used to reference the dependency property later, for operations such as setting its value programmatically or obtaining metadata.

Remarques

Une propriété jointe est un concept de propriété défini par langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML).An attached property is a property concept defined by langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML). WPFWPF implémente les propriétés jointes en tant que propriétés de dépendance.implements attached properties as dependency properties. Étant donné que les propriétés jointes WPFWPF 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 des opérations telles que la création de rapports sur les caractéristiques de la disposition.Because the WPFWPF attached properties are dependency properties, they can have metadata applied that can be used by the general property system for operations such as reporting layout characteristics. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.For more information, see Attached Properties Overview.

Pour plus d’informations sur l’inscription des propriétés de dépendance, consultez DependencyProperty.For more information on dependency property registration, see DependencyProperty.

Utiliser RegisterAttached pour les propriétés de dépendance héritant de la valeurUse RegisterAttached for Value-inheriting Dependency Properties

Un scénario particulier pour l’inscription d’une propriété de dépendance avec RegisterAttached au lieu de Register consiste à prendre en charge l’héritage de la valeur de propriété.One particular scenario for registering a dependency property with RegisterAttached instead of Register is to support property value inheritance. Vous devez inscrire des propriétés de dépendance héritant de la 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 des méthodes statiques obtenir * et Set * pour fournir les véritables accesseurs de prise en charge des propriétés attachées.You should register value-inheriting dependency properties with RegisterAttached even if the class defines property wrapper accessors that expose the dependency property, and even if you do not intend to expose Get* and Set* static methods to provide true attached property support accessors. Bien que l’héritage de la valeur de propriété puisse sembler fonctionner pour les propriétés de dépendance non jointes, le comportement d’héritage pour 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.Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain element boundaries in the runtime tree is undefined. L’inscription de la propriété attachée à la propriété attachée fait de la propriété jointe une propriété globale au système de propriétés et garantit que l’héritage de la valeur de propriété fonctionne sur toutes les limites d’une arborescence d’éléments.Registering the property as attached effectively makes the attached property a global property to the property system, and assures that property value inheritance works across all boundaries in an element tree. Utilisez toujours RegisterAttached pour inscrire les propriétés où vous spécifiez Inherits dans les métadonnées.Always use RegisterAttached to register properties where you specify Inherits in the metadata. Pour plus d’informations, consultez Héritage de valeur de propriété.For more information, see Property Value Inheritance.

Voir aussi

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é.Registers an attached property with the specified property type, owner type, property metadata, and value validation callback for the property.

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.The name of the dependency property to register.

propertyType
Type

Type de la propriété.The type of the property.

ownerType
Type

Type du propriétaire qui inscrit la propriété de dépendance.The owner type that is registering the dependency property.

defaultMetadata
PropertyMetadata

Métadonnées de propriété de la propriété de dépendance.Property metadata for the dependency property. Cela peut inclure la valeur par défaut, ainsi que d’autres caractéristiques.This can include the default value as well as other characteristics.

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.A reference to a callback that should perform any custom validation of the dependency property value beyond typical type validation.

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.A dependency property identifier that should be used to set the value of a public static readonly field in your class. 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.That identifier is then used to reference the dependency property later, for operations such as setting its value programmatically or obtaining metadata.

Exemples

L’exemple suivant inscrit une propriété jointe sur une classe abstraite à l’aide de cette RegisterAttached signature.The following example registers an attached property on an abstract class using this 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.This attached property is an enumeration type property, and the registration adds a validation callback to verify that the provided value is a value of the enumeration.

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 langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML).An attached property is a property concept defined by langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML). WPFWPF implémente les propriétés jointes en tant que propriétés de dépendance.implements attached properties as dependency properties. Étant donné que les propriétés jointes WPFWPF 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 des opérations telles que la création de rapports sur les caractéristiques de la disposition.Because the WPFWPF attached properties are dependency properties, they can have metadata applied that can be used by the general property system for operations such as reporting layout characteristics. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.For more information, see Attached Properties Overview.

Pour plus d’informations sur l’inscription des propriétés de dépendance, consultez DependencyProperty.For more information on dependency property registration, see DependencyProperty.

Utiliser RegisterAttached pour les propriétés de dépendance héritant de la valeurUse RegisterAttached for Value-inheriting Dependency Properties

Un scénario particulier pour l’inscription d’une propriété de dépendance avec RegisterAttached au lieu de Register consiste à prendre en charge l’héritage de la valeur de propriété.One particular scenario for registering a dependency property with RegisterAttached instead of Register is to support property value inheritance. Vous devez inscrire des propriétés de dépendance héritant de la 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 des méthodes statiques obtenir * et Set * pour fournir les véritables accesseurs de prise en charge des propriétés attachées.You should register value-inheriting dependency properties with RegisterAttached even if the class defines property wrapper accessors that expose the dependency property, and even if you do not intend to expose Get* and Set* static methods to provide true attached property support accessors. Bien que l’héritage de la valeur de propriété puisse sembler fonctionner pour les propriétés de dépendance non jointes, le comportement d’héritage pour 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.Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain element boundaries in the runtime tree is undefined. L’inscription de la propriété attachée à la propriété attachée fait de la propriété jointe une propriété globale au système de propriétés et garantit que l’héritage de la valeur de propriété fonctionne sur toutes les limites d’une arborescence d’éléments.Registering the property as attached effectively makes the attached property a global property to the property system, and assures that property value inheritance works across all boundaries in an element tree. Utilisez toujours RegisterAttached pour inscrire les propriétés où vous spécifiez Inherits dans les métadonnées.Always use RegisterAttached to register properties where you specify Inherits in the metadata. Pour plus d’informations, consultez Héritage de valeur de propriété.For more information, see Property Value Inheritance.

Voir aussi

S’applique à