Compartilhar via


DependencyObject.GetValue(DependencyProperty) Método

Definição

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.

public:
 System::Object ^ GetValue(System::Windows::DependencyProperty ^ dp);
public object GetValue (System.Windows.DependencyProperty dp);
member this.GetValue : System.Windows.DependencyProperty -> obj
Public Function GetValue (dp As DependencyProperty) As Object

Parâmetros

dp
DependencyProperty

O identificador DependencyProperty da propriedade para o qual o valor será recuperado.

Retornos

Retorna o valor efetivo atual.

Exceções

O dp especificado ou seu valor era inválido ou o dp especificado não existe.

Comentários

O valor efetivo é o valor da propriedade que é retornada pelo sistema de propriedades para qualquer chamador que esteja solicitando o valor. O valor efetivo é o resultado do sistema de propriedades ter avaliado todas as entradas possíveis que participam da precedência de valor do sistema de propriedades. Isso inclui coerção e animação. Para obter mais informações, consulte Precedência do valor da propriedade de dependência.

Esse método nunca retornará UnsetValue. O UnsetValue é um valor sentinela para o sistema de propriedades que é usado em várias capacidades internas e ocasionalmente também expostas por meio de retornos de chamada de coerção.

Se você não tiver certeza de qual deve ser o tipo da propriedade, poderá consultar o identificador da propriedade de dependência solicitada para determinar se há um mais específico PropertyType para o qual o valor retornado pode ser convertido.

Aplica-se a

Confira também