Como implementar uma propriedade de dependência

Este artigo descreve como implementar uma propriedade de dependência usando um DependencyProperty campo para fazer backup de uma propriedade CLR (Common Language Runtime). As propriedades de dependência dão suporte a vários recursos avançados do sistema de propriedades do WPF (Windows Presentation Foundation). Esses recursos incluem estilos, associação de dados, herança, animação e valores padrão. Se você quiser propriedades definidas para dar suporte a esses recursos, implemente suas propriedades como uma propriedade de dependência.

Exemplo

O exemplo a seguir mostra como registrar uma propriedade de dependência chamando o Register método. O Register método retorna uma DependencyProperty instância chamada identificador de propriedade de dependência. O identificador é armazenado em um static readonly campo e contém o nome e as características de uma propriedade de dependência.

O campo identificador deve seguir a convenção <property name>Propertyde nomenclatura. Por exemplo, se você registrar uma propriedade de dependência com o nome Location, o campo identificador deverá ser nomeado LocationProperty. Se você não seguir esse padrão de nomenclatura, os designers do WPF poderão não relatar sua propriedade corretamente e aspectos do aplicativo de estilo do sistema de propriedades podem não se comportar conforme o esperado.

No exemplo a seguir, o nome da propriedade de dependência e seu acessador CLR é HasFish, portanto, o campo identificador é nomeado HasFishProperty. O tipo de propriedade de dependência é Boolean e o tipo de proprietário que registra a propriedade de dependência é Aquarium.

Você pode especificar metadados padrão para uma propriedade de dependência. Este exemplo define um valor padrão da falseHasFish propriedade de dependência.

public class Aquarium : DependencyObject
{
    public static readonly DependencyProperty HasFishProperty =
        DependencyProperty.Register(
            name: "HasFish",
            propertyType: typeof(bool),
            ownerType: typeof(Aquarium),
            typeMetadata: new FrameworkPropertyMetadata(defaultValue: false));

    public bool HasFish
    {
        get => (bool)GetValue(HasFishProperty);
        set => SetValue(HasFishProperty, value);
    }
}

Public Class Aquarium
    Inherits DependencyObject

    Public Shared ReadOnly HasFishProperty As DependencyProperty =
    DependencyProperty.Register(
        name:="HasFish",
        propertyType:=GetType(Boolean),
        ownerType:=GetType(Aquarium),
        typeMetadata:=New FrameworkPropertyMetadata(defaultValue:=False))

    Public Property HasFish As Boolean
        Get
            Return GetValue(HasFishProperty)
        End Get
        Set(value As Boolean)
            SetValue(HasFishProperty, value)
        End Set
    End Property

End Class

Para obter mais informações sobre como e por que implementar uma propriedade de dependência, em vez de apenas fazer backup de uma propriedade CLR com um campo privado, consulte a visão geral das propriedades de dependência.

Consulte também

• Visão geral das propriedades de dependência
• Tópicos de tutoriais