DependencyProperty.RegisterAttached Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

WindowsBase.dll

Registra una propiedad adjunta con el sistema de propiedades.

Sobrecargas

RegisterAttached(String, Type, Type)	Registra una propiedad adjunta con el nombre de propiedad, el tipo de propiedad y el tipo de propietario especificados.
RegisterAttached(String, Type, Type, PropertyMetadata)	Registra una propiedad adjunta con el nombre de la propiedad, el tipo de propiedad, el tipo de propietario y los metadatos de propiedad especificados.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Registra una propiedad adjunta con el tipo de propiedad, el tipo de propietario, los metadatos de propiedad y una devolución de llamada de validación de valor especificados.

RegisterAttached(String, Type, Type)

Registra una propiedad adjunta con el nombre de propiedad, el tipo de propiedad y el tipo de propietario especificados.

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

Parámetros

name

String

Nombre de la propiedad de dependencia que se va a registrar.

propertyType

Type

Tipo de la propiedad.

ownerType

Type

Tipo de propietario que registra la propiedad de dependencia.

Devoluciones

DependencyProperty

Identificador de propiedad de dependencia que se debe usar para establecer el valor de un campo public static readonly en su clase. Ese identificador se usa posteriormente para hacer referencia a la propiedad de dependencia, en operaciones como el establecimiento de su valor mediante programación o la obtención de metadatos.

Ejemplos

En el ejemplo siguiente se registra una propiedad adjunta en una clase abstracta mediante esta RegisterAttached firma.

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

Comentarios

Una propiedad adjunta es un concepto de propiedad definido por extensible Application Markup Language (XAML). WPF implementa propiedades adjuntas como propiedades de dependencia. Dado que las propiedades adjuntas de WPF son propiedades de dependencia, pueden tener metadatos aplicados que el sistema de propiedades general puede usar para operaciones como las características de diseño de informes. Para más información, consulte la información general sobre propiedades adjuntas.

Para obtener más información sobre el registro de propiedades de dependencia, vea DependencyProperty.

Consulte también

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

RegisterAttached(String, Type, Type, PropertyMetadata)

Registra una propiedad adjunta con el nombre de la propiedad, el tipo de propiedad, el tipo de propietario y los metadatos de propiedad especificados.

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

Parámetros

name

String

Nombre de la propiedad de dependencia que se va a registrar.

propertyType

Type

Tipo de la propiedad.

ownerType

Type

Tipo de propietario que registra la propiedad de dependencia.

defaultMetadata

PropertyMetadata

Metadatos de propiedad de la propiedad de dependencia. Esto puede incluir el valor predeterminado, así como otras características.

Devoluciones

DependencyProperty

Identificador de propiedad de dependencia que se debe usar para establecer el valor de un campo public static readonly en su clase. Ese identificador se usa posteriormente para hacer referencia a la propiedad de dependencia, en operaciones como el establecimiento de su valor mediante programación o la obtención de metadatos.

Comentarios

Una propiedad adjunta es un concepto de propiedad definido por extensible Application Markup Language (XAML). WPF implementa propiedades adjuntas como propiedades de dependencia. Dado que las propiedades adjuntas de WPF son propiedades de dependencia, pueden tener metadatos aplicados que el sistema de propiedades general puede usar para operaciones como las características de diseño de informes. Para más información, consulte la información general sobre propiedades adjuntas.

Para obtener más información sobre el registro de propiedades de dependencia, vea DependencyProperty.

Usar RegisterAttached para las propiedades de dependencia heredadas de valor

Un escenario concreto para registrar una propiedad de dependencia con RegisterAttached en lugar de es admitir la herencia de valores de Register propiedad. Debe registrar propiedades de dependencia heredadas de valor con RegisterAttached incluso si la clase define descriptores de acceso de contenedor de propiedades que exponen la propiedad de dependencia, e incluso si no tiene previsto exponer métodos estáticos Get* y Set* para proporcionar descriptores de acceso de compatibilidad con propiedades adjuntas verdaderas. Aunque la herencia de valores de propiedad puede parecer funcionar para propiedades de dependencia no adjuntas, el comportamiento de herencia de una propiedad no adjunta a través de determinados límites de elemento en el árbol en tiempo de ejecución no está definido. El registro de la propiedad como adjunta hace que la propiedad adjunta sea una propiedad global en el sistema de propiedades y garantiza que la herencia de valores de propiedad funciona en todos los límites de un árbol de elementos. Use siempre RegisterAttached para registrar las propiedades donde especifique Inherits en los metadatos. Para más información, vea Herencia de valores de propiedad.

Consulte también

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

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

Registra una propiedad adjunta con el tipo de propiedad, el tipo de propietario, los metadatos de propiedad y una devolución de llamada de validación de valor especificados.

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

Parámetros

name

String

Nombre de la propiedad de dependencia que se va a registrar.

propertyType

Type

Tipo de la propiedad.

ownerType

Type

Tipo de propietario que registra la propiedad de dependencia.

defaultMetadata

PropertyMetadata

Metadatos de propiedad de la propiedad de dependencia. Esto puede incluir el valor predeterminado, así como otras características.

validateValueCallback

ValidateValueCallback

Referencia a una devolución de llamada que debe realizar cualquier validación personalizada del valor de la propiedad de dependencia además de la validación habitual de tipo.

Devoluciones

DependencyProperty

Identificador de propiedad de dependencia que se debe usar para establecer el valor de un campo public static readonly en su clase. Ese identificador se usa posteriormente para hacer referencia a la propiedad de dependencia, en operaciones como el establecimiento de su valor mediante programación o la obtención de metadatos.

Ejemplos

En el ejemplo siguiente se registra una propiedad adjunta en una clase abstracta mediante esta RegisterAttached firma. Esta propiedad adjunta es una propiedad de tipo de enumeración y el registro agrega una devolución de llamada de validación para comprobar que el valor proporcionado es un valor de la enumeración.

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

Comentarios

Una propiedad adjunta es un concepto de propiedad definido por extensible Application Markup Language (XAML). WPF implementa propiedades adjuntas como propiedades de dependencia. Dado que las propiedades adjuntas de WPF son propiedades de dependencia, pueden tener metadatos aplicados que el sistema de propiedades general puede usar para operaciones como las características de diseño de informes. Para más información, consulte la información general sobre propiedades adjuntas.

Para obtener más información sobre el registro de propiedades de dependencia, vea DependencyProperty.

Usar RegisterAttached para las propiedades de dependencia heredadas de valor

Un escenario concreto para registrar una propiedad de dependencia con RegisterAttached en lugar de es admitir la herencia de valores de Register propiedad. Debe registrar propiedades de dependencia heredadas de valor con RegisterAttached incluso si la clase define descriptores de acceso de contenedor de propiedades que exponen la propiedad de dependencia, e incluso si no tiene previsto exponer métodos estáticos Get* y Set* para proporcionar descriptores de acceso de compatibilidad con propiedades adjuntas verdaderas. Aunque la herencia de valores de propiedad puede parecer funcionar para propiedades de dependencia no adjuntas, el comportamiento de herencia de una propiedad no adjunta a través de determinados límites de elemento en el árbol en tiempo de ejecución no está definido. El registro de la propiedad como adjunta hace que la propiedad adjunta sea una propiedad global en el sistema de propiedades y garantiza que la herencia de valores de propiedad funciona en todos los límites de un árbol de elementos. Use siempre RegisterAttached para registrar las propiedades donde especifique Inherits en los metadatos. Para más información, vea Herencia de valores de propiedad.

Consulte también

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