DependencyProperty Clase

Definición

Representa una propiedad que se puede establecer a través de métodos como, por ejemplo, el estilo, el enlace de datos, la animación y la herencia.Represents a property that can be set through methods such as, styling, data binding, animation, and inheritance.

public ref class DependencyProperty sealed
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
Herencia
DependencyProperty
Atributos

Comentarios

Una DependencyProperty admite las siguientes funcionalidades en Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):A DependencyProperty supports the following capabilities in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):

  • La propiedad se puede establecer en un estilo.The property can be set in a style. Para obtener más información, consulte Aplicar estilos y plantillas.For more information, see Styling and Templating.

  • La propiedad se puede establecer mediante el enlace de datos.The property can be set through data binding. Para obtener más información sobre las propiedades de dependencia de enlace de datos, vea How to: Enlazar las propiedades de dos controles.For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • La propiedad se puede establecer con una referencia de recursos dinámicos.The property can be set with a dynamic resource reference. Para obtener más información, consulte Recursos XAML.For more information, see XAML Resources.

  • La propiedad puede heredar su valor automáticamente de un elemento primario en el árbol de elementos.The property can inherit its value automatically from a parent element in the element tree. Para más información, vea Herencia de valores de propiedad.For more information, see Property Value Inheritance.

  • La propiedad se puede animar.The property can be animated. Para obtener más información, consulte Información general sobre animaciones.For more information, see Animation Overview.

  • La propiedad puede informar cuando se ha cambiado el valor anterior de la propiedad y se puede forzar el valor de la propiedad.The property can report when the previous value of the property has been changed and the property value can be coerced. Para obtener más información, consulte Devoluciones de llamada y validación de las propiedades de dependencia.For more information, see Dependency Property Callbacks and Validation.

  • La propiedad informa de la información que se va a WPFWPF, por ejemplo, si el cambio de un valor de propiedad debe requerir que el sistema de diseño recomponga los objetos visuales de un elemento.The property reports information to WPFWPF, such as whether changing a property value should require the layout system to recompose the visuals for an element.

  • La propiedad recibe compatibilidad en el WPF Designer para Visual StudioWPF Designer for Visual Studio.The property receives support in the WPF Designer para Visual StudioWPF Designer for Visual Studio. Por ejemplo, la propiedad se puede editar en la ventana propiedades .For example, the property can be edited in the Properties window.

Para más información sobre las propiedades de dependencia, consulte información general sobre las propiedades de dependencia.To learn more about dependency properties, see Dependency Properties Overview. Si desea que las propiedades de los tipos personalizados admitan las funciones de la lista anterior, debe crear una propiedad de dependencia.If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. Para obtener información sobre cómo crear propiedades de dependencia personalizadas, consulte propiedades de dependencia personalizadas.To learn how to create custom dependency properties, see Custom Dependency Properties.

Una propiedad adjunta es una propiedad que permite que cualquier objeto informe de información al tipo que define la propiedad adjunta.An attached property is a property that enables any object to report information to the type that defines the attached property. En WPFWPF, cualquier tipo que herede de DependencyObject puede usar una propiedad adjunta independientemente de si el tipo hereda del tipo que define la propiedad.In WPFWPF, any type that inherits from DependencyObject can use an attached property regardless of whether the type inherits from the type that defines the property. Una propiedad adjunta es una característica del lenguaje XAMLXAML.An attached property is a feature of the XAMLXAML language. Para establecer una propiedad adjunta en XAMLXAML, use el valor de ownerType. Sintaxis de PropertyName .To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. Un ejemplo de una propiedad adjunta es la propiedad DockPanel.Dock.An example of an attached property is the DockPanel.Dock property. Si desea crear una propiedad que se pueda usar en todos los tipos de DependencyObject, debe crear una propiedad adjunta.If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. Para obtener más información sobre las propiedades adjuntas, incluida la forma de crearlas, consulte información general sobre las propiedades adjuntas.To learn more about attached properties, including how to create them, see Attached Properties Overview.

Uso de atributos XAMLXAML Attribute Usage

<object property="dependencyPropertyName"/>  

o bien-or-

<object property="ownerType.dependencyPropertyName"/>  

O bien-or-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Valores XAMLXAML Values

dependencyPropertyName
Cadena que especifica el DependencyProperty.Name de la propiedad de dependencia deseada.A string that specifies the DependencyProperty.Name of the desired dependency property. Esto puede ir precedido de un prefijo de espacio de nombres XML si la propiedad no está en el espacio de nombres XML predeterminado (para obtener más información, vea espacios de nombres y asignación de espacios de nombres XAML para WPF).This can be preceded by an XML namespace prefix if the property is not in the default XML namespace (for details, see XAML Namespaces and Namespace Mapping for WPF XAML.)

ownerType.dependencyPropertyNameownerType.dependencyPropertyName
Cadena que especifica el tipo de propietario de una propiedad de dependencia, un punto (.) y, a continuación, el DependencyProperty.Name.A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType también puede ir precedido de un prefijo de espacio de nombres XML.ownerType can also be preceded by an XML namespace prefix. Este uso es específico de los estilos y las plantillas enlazados en tiempo de ejecución, donde se debe especificar el propietario de la propiedad de dependencia para analizar el contexto, ya que el TargetType aún no se conoce.This usage is particular to late-bound styles and templates, where the owner of the dependency property must be specified for parsing context because the TargetType is not yet known. Para obtener más información, consulte Aplicar estilos y plantillas.For more information, see Styling and Templating.

attachedPropertyOwnerType .attachedPropertyOwnerType . attachedPropertyName
Una cadena que especifica el propietario de una propiedad adjunta, un punto (.) y el nombre de la propiedad adjunta.A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType también puede ir precedido de un prefijo de espacio de nombres XML.attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

Campos

UnsetValue

Especifica un valor estático que usa el sistema de propiedades de WPFWPF en vez de null para indicar que la propiedad existe, pero el sistema de propiedades no ha establecido su valor.Specifies a static value that is used by the WPFWPF property system rather than null to indicate that the property exists, but does not have its value set by the property system.

Propiedades

DefaultMetadata

Obtiene los metadatos predeterminados de la propiedad de dependencia.Gets the default metadata of the dependency property.

GlobalIndex

Obtiene un valor generado internamente que identifica exclusivamente la propiedad de dependencia.Gets an internally generated value that uniquely identifies the dependency property.

Name

Obtiene el nombre de la propiedad de dependencia.Gets the name of the dependency property.

OwnerType

Obtiene el tipo del objeto que registró la propiedad de dependencia con el sistema de propiedades o se agregó a sí mismo como su propietario.Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType

Obtiene el tipo que usa la propiedad de dependencia para su valor.Gets the type that the dependency property uses for its value.

ReadOnly

Obtiene un valor que indica si la propiedad de dependencia identificada por esta instancia de DependencyProperty es una propiedad de dependencia de sólo lectura.Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback

Obtiene la devolución de llamada de validación del valor de la propiedad de dependencia.Gets the value validation callback for the dependency property.

Métodos

AddOwner(Type)

Agrega otro tipo como propietario de una propiedad de dependencia que ya está registrada.Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata)

Agrega otro tipo como propietario de una propiedad de dependencia que ya se ha registrado y ofrece los metadatos de propiedad de dependencia para la propiedad de dependencia como se verá en el tipo de propietario proporcionado.Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Devuelve un código hash para esta DependencyProperty.Returns a hash code for this DependencyProperty.

GetMetadata(DependencyObject)

Devuelve los metadatos de esta propiedad de dependencia tal como existe en la instancia de objeto especificado.Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType)

Devuelve los metadatos de esta propiedad de dependencia tal como existe en un tipo especificado.Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type)

Devuelve los metadatos de esta propiedad de dependencia tal como existe en un tipo especificado.Returns the metadata for this dependency property as it exists on a specified existing type.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsValidType(Object)

Determina si un valor especificado es aceptable para el tipo de esta propiedad de dependencia, como se ha comprobado en el tipo de propiedad proporcionado en el registro de propiedad de dependencia original.Determines whether a specified value is acceptable for this dependency property's type, as checked against the property type provided in the original dependency property registration.

IsValidValue(Object)

Determina si el valor proporcionado se acepta para el tipo de propiedad mediante la comprobación de tipo básico y, potencialmente, si está comprendido en el intervalo permitido de valores de ese tipo.Determines whether the provided value is accepted for the type of property through basic type checking, and also potentially if it is within the allowed range of values for that type.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OverrideMetadata(Type, PropertyMetadata)

Especifica los metadatos alternativos para esta propiedad de dependencia cuando se encuentra en instancias de un tipo especificado y reemplaza los metadatos existentes para la propiedad de dependencia tal y como se heredó de los tipos base.Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Proporciona los metadatos alternativos para una propiedad de dependencia de solo lectura cuando se encuentra en instancias de un tipo especificado y reemplaza los metadatos que se proporcionaron en el registro inicial de la propiedad de dependencia.Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. Debe pasar la DependencyPropertyKey para la propiedad de dependencia de solo lectura evitar que se genere una excepción.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

Register(String, Type, Type)

Registra una propiedad de dependencia con el nombre de propiedad, el tipo de propiedad y el tipo de propietario especificados.Registers a dependency property with the specified property name, property type, and owner type.

Register(String, Type, Type, PropertyMetadata)

Registra una propiedad de dependencia con el nombre de la propiedad, el tipo de propiedad, el tipo de propietario y los metadatos de propiedad especificados.Registers a dependency property with the specified property name, property type, owner type, and property metadata.

Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra una propiedad de dependencia con los valores especificados de nombre de la propiedad, tipo de propiedad, tipo de propietario, metadatos de propiedad y una devolución de llamada de validación de la propiedad.Registers a dependency property with the specified property name, property type, owner type, property metadata, and a value validation callback for the property.

RegisterAttached(String, Type, Type)

Registra una propiedad adjunta con el nombre de propiedad, el tipo de propiedad y el tipo de propietario especificados.Registers an attached property with the specified property name, property type, and owner type.

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

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

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Registra una propiedad adjunta de solo lectura, con el tipo de propiedad, el tipo de propietario y los metadatos de propiedad especificados.Registers a read-only attached property, with the specified property type, owner type, and property metadata.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra una propiedad adjunta de solo lectura, con el tipo de propiedad, el tipo de propietario, los metadatos de propiedad y una devolución de llamada de validación especificados.Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

Registra una propiedad de dependencia de solo lectura, con el tipo de propiedad, el tipo de propietario y los metadatos de propiedad especificados.Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra una propiedad de dependencia de solo lectura, con el tipo de propiedad, el tipo de propietario, los metadatos de propiedad y una devolución de llamada de validación especificados.Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString()

Devuelve la representación de cadena de la propiedad de dependencia.Returns the string representation of the dependency property.

Se aplica a

Consulte también: