DependencyProperty.Register Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 DependencyPropertyParâmetros
- name
-
String
winrt::hstring
O nome da propriedade de dependência a ser registrada.
O tipo de proprietário que está registrando a propriedade de dependência, como uma referência de tipo..
- 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 como null o parâmetro de valor padrão.
Retornos
Um identificador de propriedade de dependência que normalmente é armazenado em um campo somente leitura estático público em sua classe derivada DependencyObject . Em seguida, o identificador é usado por seu próprio código e qualquer código de usuário de terceiros para fazer referência à 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 o registro varia, com base na linguagem de programação. Para C#, é 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 C++, 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 C++, consulte propriedades de dependência personalizadas.