DependencyPropertyKey Classe

Definição

public ref class DependencyPropertyKey sealed

public sealed class DependencyPropertyKey

type DependencyPropertyKey = class

Public NotInheritable Class DependencyPropertyKey

Herança

Object

DependencyPropertyKey

Exemplos

O exemplo a seguir registra uma propriedade de dependência somente leitura e também usa a chave para duas finalidades em outros membros da classe: implementar o "wrapper" get e como o identificador para uma operação de determinação protegida que define o valor com base nos cálculos de outros valores de propriedade.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}

Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

Comentários

DependencyPropertyKey instâncias são obtidas como o valor retornado de uma chamada de registro de propriedade de dependência usando os métodos RegisterReadOnly ou RegisterAttachedReadOnly.

Os tipos que registram uma propriedade de dependência podem usar o DependencyPropertyKey em chamadas para SetValue e ClearValue que ajustam o valor da propriedade como parte da lógica de classe. Se permitido pelo nível de acesso da chave, as classes relacionadas também podem usar a chave e a propriedade de dependência. Por exemplo, você pode declarar a chave como interna e outros tipos dentro do mesmo assembly também podem definir essa propriedade de dependência.

O DependencyPropertyKey retornado pelo registro de propriedade de dependência somente leitura não deve ser tornado público, pois expor a chave torna a propriedade configurável, derrotando assim o ponto de registrá-la como uma propriedade de dependência somente leitura. Além disso, expor a chave causa uma incompatibilidade entre os comportamentos de propriedade de dependência disponíveis e suas implementações de wrapper de propriedade CLR (Common Language Runtime), que é um design de classe inválido.

Em vez de expor a chave em si, você deve expor o valor DependencyProperty do DependencyPropertyKey como um public static readonlyDependencyProperty em sua classe. Isso permite que a propriedade retorne um identificador de propriedade de dependência válido para determinadas operações do sistema de propriedades, como enumerar valores definidos localmente. No entanto, o identificador obtido, portanto, não tem os recursos completos de um DependencyProperty para muitas operações do sistema de propriedades.

Propriedades

Métodos

Aplica-se a

Confira também

• DependencyProperty