DependencyObject.GetValue(DependencyProperty) Método

Definição

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a 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.The DependencyProperty identifier of the property to retrieve the value for.

Retornos

Retorna o valor efetivo atual.Returns the current effective value.

Exceções

O dp especificado ou seu valor era inválido ou o dp especificado não existe.The specified dp or its value was invalid, or the specified dp does not exist.

Comentários

O valor efetivo é o valor da propriedade que é retornado pelo sistema de propriedades para qualquer chamador que está solicitando o valor.The effective value is the value of the property that is returned by the property system to any caller that is requesting the value. O valor efetivo é o resultado do sistema de propriedades ter avaliado todas as entradas possíveis que participam da propriedade de precedência de valor do sistema.The effective value is the result of the property system having evaluated all the possible inputs that participate in the property system value precedence. Isso inclui coerção e animação.This includes coercion and animation. Para obter mais informações, consulte Precedência do valor da propriedade de dependência.For more information, see Dependency Property Value Precedence.

Esse método nunca retornará UnsetValue.This method will never return UnsetValue. O UnsetValue é um valor de sentinela para o sistema de propriedades que é usado em várias capacidades internamente e, ocasionalmente, também exposto por retornos de chamada de coerção.The UnsetValue is a sentinel value for the property system that is used in various capacities internally and occasionally also exposed through coercion callbacks.

Se você não tiver certeza de qual tipo de propriedade deve ser, poderá consultar o identificador da propriedade de dependência solicitada para determinar se há um PropertyType mais específico para o qual o valor de retorno pode ser convertido.If you are not sure what the property's type should be, you can query the identifier of the requested dependency property to determine whether there is a more specific PropertyType that the return value can be converted to.

Aplica-se a

Veja também