DependencyProperty.Register Método

Definição

Namespace:

Windows.UI.Xaml

Registra uma propriedade de dependência com o nome da propriedade, o tipo de propriedade, o tipo de proprietário e os metadados de propriedade especificados para a propriedade. Use esse método ao definir ou inicializar uma classe derivada DependencyObject que será proprietária da propriedade de dependência 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

O nome da propriedade de dependência a ser registrada.

propertyType

TypeName Type

O tipo da propriedade, como uma referência de tipo (System.Type para Microsoft .NET, um struct auxiliar TypeName para extensões de componente do Visual C++ (C++/CX)).

ownerType

TypeName Type

O tipo de proprietário que está registrando a propriedade de dependência, como uma referência de tipo (System.Type para Microsoft .NET, um struct auxiliar TypeName para extensões de componente do Visual C++ (C++/CX)).

typeMetadata

PropertyMetadata

Uma instância de metadados de propriedade. Isso pode conter um valor padrão e uma referência de implementação PropertyChangedCallback . Passar null para esse parâmetro é equivalente a passar uma nova instância PropertyMetadata criada chamando PropertyMetadata.Create com null como o parâmetro de valor padrão.

Retornos

DependencyProperty

Um identificador de propriedade de dependência que normalmente é armazenado em um campo público estático somente leitura em sua classe derivada DependencyObject . Em seguida, o identificador é usado pelo seu próprio código e por qualquer código de usuário de terceiros para referenciar a propriedade de dependência posteriormente, para operações como definir seu valor programaticamente ou anexar uma Associação no código.

Comentários

Como registrar uma propriedade de dependência personalizada é descrito em detalhes (com exemplos) no tópico Propriedades de dependência personalizadas.

O registro de uma propriedade de dependência normalmente é algo que você só faz quando um aplicativo é iniciado pela primeira vez ou as classes derivadas dependencyObject definidas pelo código do aplicativo são usadas pela primeira vez. Você precisa registrar as propriedades de dependência no início do tempo de vida do aplicativo para garantir que outro código e XAML em seu aplicativo não tentem usar as propriedades de dependência antes de serem registradas e disponíveis. Exatamente como e quando registrar variam, com base na linguagem de programação. Para C# ou Microsoft Visual Basic, é comum registrar propriedades de dependência durante a inicialização de classe estática da classe que possui a propriedade de dependência. Dessa forma, qualquer código ou XAML que inicialize a instância invocará essa construção estática e registrará a propriedade de dependência. Para extensões de componente do Visual C++ (C++/CX),a inicialização de classe estática não é uma técnica disponível, portanto, você normalmente deve definir um método auxiliar em todo o aplicativo que registra todas as propriedades de dependência personalizadas que seu aplicativo pretende usar, como parte da inicialização do objeto Application . Para obter exemplos de como e quando registrar propriedades de dependência personalizadas, incluindo algumas técnicas especiais necessárias para extensões de componente do Visual C++ (C++/CX), consulte Propriedades de dependência personalizadas.

Confira também

• Propriedades de dependência personalizadas
• Visão geral das propriedades de dependência
• Usuário XAML e exemplo de controles personalizados