Idioma

DependencyObject Classe

Definição

Namespace:
Windows.UI.Xaml
Editar

Representa um objeto que participa do sistema de propriedades de dependência. DependencyObject é a classe base imediata de muitas classes importantes relacionadas à interface do usuário, como UIElement, Geometry, FrameworkTemplate, Style e ResourceDictionary. Para obter mais informações sobre como DependencyObject dá suporte a propriedades de dependência, consulte a visão geral das propriedades de dependência.

public ref class DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DependencyObject
Public Class DependencyObject
Herança
Object Platform::Object IInspectable DependencyObject
Derivado
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Requisitos Description
Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo define uma classe que deriva de DependencyObject e define uma propriedade anexada junto com o campo identificador. O cenário para essa classe é que é uma classe de serviço que declara uma propriedade anexada que outros elementos de interface do usuário podem definir em XAML O serviço potencialmente atua nos valores da propriedade anexada nesses elementos de interface do usuário em tempo de execução.

public abstract class AquariumServices : DependencyObject
{
    public enum Buoyancy {Floats,Sinks,Drifts}

    public static readonly DependencyProperty BuoyancyProperty = DependencyProperty.RegisterAttached(
      "Buoyancy",
      typeof(Buoyancy),
      typeof(AquariumServices),
      new PropertyMetadata(Buoyancy.Floats)
    );
    public static void SetBuoyancy(DependencyObject element, Buoyancy value)
    {
        element.SetValue(BuoyancyProperty, value);
    }
    public static Buoyancy GetBuoyancy(DependencyObject element)
    {
        return (Buoyancy)element.GetValue(BuoyancyProperty);
    }
}

Public Class AquariumServices
    Inherits DependencyObject
    Public Enum Buoyancy
        Floats
        Sinks
        Drifts
    End Enum

    Public Shared ReadOnly BuoyancyProperty As DependencyProperty = _
          DependencyProperty.RegisterAttached(
          "Buoyancy", _
          GetType(Buoyancy), _
          GetType(AquariumServices), _
          New PropertyMetadata(Buoyancy.Floats))


    Public Sub SetBuoyancy(element As DependencyObject, value As Buoyancy)
        element.SetValue(BuoyancyProperty, value)
    End Sub
    Public Function GetBuoyancy(element As DependencyObject) As Buoyancy
        GetBuoyancy = CType(element.GetValue(BuoyancyProperty), Buoyancy)
    End Function
End Class

public static bool ClearSetProperty(DependencyObject targetObject, DependencyProperty targetDP)
{
    if (targetObject == null || targetDP == null)
    {
        throw new ArgumentNullException();
    }
    object localValue = targetObject.ReadLocalValue(targetDP);
    if (localValue == DependencyProperty.UnsetValue)
    {
        return false;
    }
    else
    {
        targetObject.ClearValue(targetDP);
        return true;
    }
}

Public Shared Function ClearSetProperty(targetObject As DependencyObject, targetDP As DependencyProperty) As Boolean
    If targetObject Is Nothing Or targetDP Is Nothing Then
        Throw New ArgumentNullException()
    End If
    Dim localValue As Object = targetObject.ReadLocalValue(targetDP)
    If localValue = DependencyProperty.UnsetValue Then
        ClearSetProperty = False
    Else
        targetObject.ClearValue(targetDP)
        ClearSetProperty = True
    End If
End Function

Este exemplo mostra uma declaração de propriedade de dependência simples. Uma chamada para GetValue constitui a totalidade da implementação do acessador get para o wrapper de propriedade da nova propriedade de dependência. Uma chamada para SetValue constitui a totalidade da implementação do acessador definido . Para obter mais exemplos, consulte propriedades de dependência personalizadas.

public class Fish : Control
{
    public static readonly DependencyProperty SpeciesProperty =
    DependencyProperty.Register(
    "Species",
    typeof(String),
    typeof(Fish), null
    );
    public string Species
    {
        get { return (string)GetValue(SpeciesProperty); }
        set { SetValue(SpeciesProperty, (string)value); }
    }
}

Public Class Fish
    Inherits Control

    Public Shared ReadOnly SpeciesProperty As DependencyProperty = _
    DependencyProperty.Register(
    "Species", _
    GetType(String), _
    GetType(Fish), _
    Nothing)
    Public Property Species As String
        Get
            Species = CType(GetValue(SpeciesProperty), String)
        End Get
        Set(value As String)
            SetValue(SpeciesProperty, value)
        End Set
    End Property
End Class

Comentários

A classe DependencyObject permite serviços do sistema de propriedades de dependência em suas muitas classes derivadas. Para obter mais informações sobre o conceito de propriedade de dependência, consulte a visão geral das propriedades de dependência.

A função primária do sistema de propriedades de dependência é calcular os valores das propriedades e fornecer notificação do sistema sobre valores que foram alterados. Outra classe chave que participa do sistema de propriedades de dependência é DependencyProperty. DependencyProperty permite o registro de propriedades de dependência no sistema de propriedades, enquanto DependencyObject como uma classe base permite que os objetos usem e defina as propriedades de dependência.

Aqui estão alguns serviços e características notáveis que DependencyObject fornece ou dá suporte:

  • Suporte à hospedagem de propriedade de dependência para as propriedades de dependência de Windows Runtime existentes.
  • Suporte à hospedagem de propriedade de dependência personalizada. Registre uma propriedade de dependência chamando o método Register e armazenando o valor retornado do método como uma propriedade estática pública em sua classe DependencyObject.
  • Suporte à hospedagem de propriedade anexada para as propriedades anexadas Windows Runtime existentes.
  • Suporte personalizado de hospedagem de propriedade anexada. Registre uma propriedade de dependência para o uso da propriedade anexada chamando o método RegisterAttached e armazenando o valor retornado do método como uma propriedade estática pública em sua classe.
  • Obter e definir métodos utilitários para valores de quaisquer propriedades de dependência que existam em um DependencyObject. Você os usa ao definir a propriedade de dependência personalizada "wrappers" e também pode usá-los do código do aplicativo como uma alternativa ao uso de propriedades existentes de "wrapper".
  • Utilitário de cenário avançado para examinar metadados ou valores de propriedade (por exemplo , GetAnimationBaseValue).
  • Imposição de afinidade de thread ao thread principal da interface do usuário do Windows Runtime para todas as instâncias dependencyObject.
  • A propriedade Dispatcher para cenários avançados de threading. Obter o valor do Dispatcher fornece uma referência a um objeto CoreDispatcher . Com o CoreDispatcher, um thread de trabalho pode executar código que usa dependencyObject, mas não está no thread da interface do usuário, pois o CoreDispatcher pode adiar a execução para uma operação assíncrona que não bloqueará ou interferirá no thread da interface do usuário. Consulte a seção "DependencyObject e threading" abaixo.
  • Suporte básico de associação e estilo de dados, permitindo que as propriedades sejam definidas como expressões a serem avaliadas posteriormente no tempo de vida de um objeto. Esses conceitos são explicados com mais detalhes na visão geral das propriedades de dependência. Veja também a associação de dados detalhadamente.

DependencyObject e encadeamento

Todas as instâncias dependencyObject devem ser criadas no thread de interface do usuário associado à janela atual de um aplicativo. Isso é imposto pelo sistema e há duas implicações importantes para o código:

  • O código que usa a API de duas instâncias DependencyObject sempre será executado no mesmo thread, que é sempre o thread da interface do usuário. Normalmente, você não tem problemas de threading neste cenário.
  • O código que não está em execução no thread principal da interface do usuário não pode acessar um DependencyObject diretamente porque um DependencyObject tem afinidade de thread somente com o thread da interface do usuário. Somente o código executado no thread da interface do usuário pode alterar ou até mesmo ler o valor de uma propriedade de dependência. Por exemplo, um thread de trabalho que você iniciou com uma Tarefa .NET ou um thread ThreadPool explícito não será capaz de ler propriedades de dependência ou chamar outras APIs.

Você não está completamente impedido de usar um DependencyObject de um thread de trabalho. Mas você deve obter um objeto CoreDispatcher (o valor de DependencyObject.Dispatcher) de um DependencyObject para atravessar a separação deliberada entre o thread da interface do usuário do aplicativo e quaisquer outros threads em execução no sistema. O CoreDispatcher expõe o método RunAsync . Chame RunAsync para executar seu código aguardável (um IAsyncAction). Se for um código simples, você poderá usar uma expressão lambda, caso contrário, poderá implementar como delegado (DispatchedHandler). O sistema determina uma hora em que seu código pode ser executado. Como está habilitando o acesso entre threads, DependencyObject.Dispatcher é a única API de instância de DependencyObject ou qualquer uma de suas subclasses que podem ser acessadas de um thread que não é da interface do usuário sem gerar uma exceção entre threads. Todas as outras APIs DependencyObject geram uma exceção se você tentar chamá-las de um thread de trabalho ou de qualquer outro thread que não seja da interface do usuário.

Os problemas de threading geralmente podem ser evitados no código de interface do usuário típico. No entanto, os dispositivos geralmente não são associados ao thread da interface do usuário. Se você estiver usando informações obtidas de um dispositivo para atualizar a interface do usuário em tempo real, geralmente deverá obter um CoreDispatcher para que possa atualizar a interface do usuário. Os serviços são outro caso em que o código usado para acessar o serviço pode não estar em execução no thread da interface do usuário.

Um cenário de código em que você poderá encontrar problemas de threading relacionados a DependencyObject se estiver definindo seus próprios tipos DependencyObject e tentar usá-los para fontes de dados ou outros cenários em que um DependencyObject não é necessariamente apropriado (porque o objeto não está diretamente relacionado à interface do usuário). Por exemplo, você pode estar tentando otimizações de perf com threads em segundo plano ou outros threads de trabalho que estão alterando valores dos objetos antes da apresentação ou em resposta a um dispositivo, serviço ou outra entrada externa. Avalie se você realmente precisa de propriedades de dependência para seu cenário; talvez as propriedades padrão sejam adequadas.

Classes derivadas de DependencyObject

DependencyObject é a classe pai de várias classes derivadas imediatamente que são fundamentais para o modelo de programação que você usa para seu aplicativo e sua interface do usuário XAML. Aqui estão algumas das classes derivadas notáveis:

Construtores

Nome Description
DependencyObject()

Fornece o comportamento de inicialização de classe base para classes derivadas dependencyObject .

Propriedades

Nome Description
Dispatcher

Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar o DependencyObject no thread da interface do usuário, mesmo que o código seja iniciado por um thread que não seja da interface do usuário.

Métodos

Nome Description
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade de dependência.
GetAnimationBaseValue(DependencyProperty)

Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria em casos em que uma animação não está ativa.
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject.
ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, se um valor local for definido.
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra uma função de notificação para escutar alterações em um DependencyProperty específico nesta instância dependencyObject .
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência em um DependencyObject.
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback.

Aplica-se a

Confira também