Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método DependencyProperty.RegisterAttachedReadOnly (String, Type, Type, PropertyMetadata)

 

Registra propriedade anexadasomente leitura, com o tipo de propriedade especificado, tipo do proprietário, e metadados de propriedade.

Namespace:   System.Windows
Assembly:  WindowsBase (em WindowsBase.dll)

public static DependencyPropertyKey RegisterAttachedReadOnly(
	string name,
	Type propertyType,
	Type ownerType,
	PropertyMetadata defaultMetadata
)

Parâmetros

name

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

propertyType

O tipo da propriedade.

ownerType

O tipo do proprietário que está registrando a propriedade de dependência.

defaultMetadata

Metadados de propriedade para a propriedade de dependência.

Valor de retorno

Type: System.Windows.DependencyPropertyKey

Uma chave de propriedade de dependência que deve ser usada para definir o valor de um campo somente leitura estático na classe, que é usada para referência posterior a propriedade de dependência.

Esse método retorna o tipo DependencyPropertyKey, enquanto o RegisterAttached retorna o tipo DependencyProperty.Normalmente, as chaves que representam propriedades somente leitura não são feitas públicas, porque as chaves podem ser usadas para definir o valor da propriedade de dependência chamando SetValue(DependencyPropertyKey, Object).O design da classe afetará seus requisitos, mas geralmente é recomendável limitar o acesso e a visibilidade de qualquer DependencyPropertyKey apenas 2 as partes do código necessárias para definir essa propriedade de dependência como parte da classe ou da lógica do aplicativo.Também é recomendável expõe um identificador de propriedade de dependência para a propriedade somente leitura de dependências, expõe o valor de DependencyPropertyKey.DependencyProperty como um campo de public static readonly em sua classe.

As propriedades anexadas somente leitura é um cenário raro, porque o cenário primário para uma propriedade é anexada seu uso em XAML.Sem um setters utilitário, uma propriedade anexada não pode ser definida na sintaxe de XAML .

Para obter mais informações sobre o registro de propriedade de dependência, consulte DependencyProperty.

Um cenário específico para registrar uma propriedade de dependência como anexado é dar suporte à herança do valor da propriedade.Você deve registrar a herdando propriedades de dependência com RegisterAttached mesmo se a classe define os acessadores de wrapper da propriedade que expõe a propriedade de dependência, e se você não pretende expor métodos estáticos de Get* e de Set* para fornecer acessadores true de suporte à propriedade anexada. Embora a herança de valor de propriedade pode parecer trabalhar para propriedades nonattached de dependência, o comportamento de herança para uma propriedade nonattached com alguns limites do elemento na árvore de tempo de execução é indefinido.Registrar a propriedade como anexada efetivamente torna a propriedade anexada uma propriedade global no sistema de propriedade e, assegura-a que a herança do valor de propriedade trabalha em todos os limites em uma árvore do elemento.Sempre use RegisterAttached para registrar as propriedades onde você especificar Inherits nos metadados.Para obter mais informações, consulte Herança de Valor de Propriedade.

.NET Framework
Disponível desde 3.0
Retornar ao topo
Mostrar: