DependencyProperty.Register Método

Definición

Espacio de nombres:

Windows.UI.Xaml

Registra una propiedad de dependencia con el nombre de propiedad, el tipo de propiedad, el tipo de propietario y los metadatos de propiedad especificados para la propiedad. Use este método al definir o inicializar una clase derivada dependencyObject que poseerá la propiedad de dependencia registrada.

 static DependencyProperty Register(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& typeMetadata);

public static DependencyProperty Register(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata typeMetadata);

function register(name, propertyType, ownerType, typeMetadata)

Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyProperty

Parámetros

name

String

winrt::hstring

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

propertyType

TypeName Type

Tipo de la propiedad, como referencia de tipo (System.Type para Microsoft .NET, un struct auxiliar TypeName para extensiones de componentes de Visual C++ (C++/CX)).

ownerType

TypeName Type

Tipo de propietario que registra la propiedad de dependencia, como referencia de tipo (System.Type para Microsoft .NET, un struct auxiliar TypeName para extensiones de componentes de Visual C++ (C++/CX)).

typeMetadata

PropertyMetadata

Instancia de metadatos de propiedad. Esto puede contener un valor predeterminado y una referencia de implementación PropertyChangedCallback . Pasar null para este parámetro equivale a pasar una nueva instancia propertyMetadata creada llamando a PropertyMetadata.Create con null como parámetro de valor predeterminado.

Devoluciones

DependencyProperty

Identificador de propiedad de dependencia que normalmente se almacena en un campo público de solo lectura estático en la clase derivada DependencyObject . A continuación, su propio código usa el identificador y cualquier código de usuario de terceros para hacer referencia a la propiedad de dependencia más adelante, para operaciones como establecer su valor mediante programación o adjuntar un enlace en el código.

Comentarios

Cómo registrar una propiedad de dependencia personalizada se describe con detalle (con ejemplos) en el tema Propiedades de dependencia personalizadas.

El registro de una propiedad de dependencia suele ser algo que solo se hace cuando se inicia por primera vez una aplicación o se usan primero las clases derivadas dependencyObject definidas por el código de la aplicación. Debes registrar las propiedades de dependencia al principio de la vigencia de la aplicación para garantizar que otros código y XAML de la aplicación no intenten usar las propiedades de dependencia antes de que estén registradas y disponibles. Exactamente cómo y cuándo registrarse varían en función del lenguaje de programación. Para C# o Microsoft Visual Basic, es habitual registrar propiedades de dependencia durante la inicialización de clase estática de la clase que posee la propiedad de dependencia. De este modo, cualquier código o XAML que inicialice la instancia invocará esa construcción estática y registrará la propiedad de dependencia. En el caso de las extensiones de componentes de Visual C++ (C++/CX), la inicialización de clases estáticas no es una técnica disponible, por lo que normalmente debe definir un método auxiliar para toda la aplicación que registre todas las propiedades de dependencia personalizadas que la aplicación pretende usar, como parte de la inicialización del objeto Application . Para obtener ejemplos de cómo y cuándo registrar propiedades de dependencia personalizadas, incluidas algunas técnicas especiales necesarias para las extensiones de componentes de Visual C++ (C++/CX), consulte Propiedades de dependencia personalizadas.

Consulte también

• Propiedades de dependencia personalizadas
• Introducción a las propiedades de dependencia
• Muestra de controles de usuario y personalizados de XAML