Compartilhar via


DependencyObject.SetValue(DependencyProperty, Object) Método

Definição

Define o valor local de uma propriedade de dependência em um DependencyObject.

public:
 virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;
void SetValue(DependencyProperty const& dp, IInspectable const& value);
public void SetValue(DependencyProperty dp, object value);
function setValue(dp, value)
Public Sub SetValue (dp As DependencyProperty, value As Object)

Parâmetros

dp
DependencyProperty

O identificador da propriedade de dependência a ser definida.

value
Object

Platform::Object

IInspectable

O novo valor local.

Comentários

Se o tipo de valor fornecido não corresponder ao tipo declarado para a propriedade de dependência como ela foi registrada originalmente, uma exceção será gerada.

Nem todas as propriedades Windows Runtime usadas pelo XAML são propriedades de dependência. Um identificador DependencyProperty precisa existir e deve estar disponível como uma propriedade pública de um objeto proprietário, normalmente o objeto que registrou a propriedade.

Para o código do usuário do aplicativo, a chamada SetValue normalmente não é necessária. Normalmente, uma propriedade de dependência Windows Runtime ou uma propriedade de dependência personalizada tem uma propriedade convencional que a encapsula, e você pode apenas definir o valor da propriedade por meio de um uso pontilhado convencional. Os casos em que você ainda pode usar SetValue são:

  • Você está definindo uma propriedade de dependência personalizada. Você chamará SetValue como parte da definição de seu próprio acessador de conjunto de propriedades para um uso de propriedade convencional. Para saber mais, consulte Propriedades de dependência personalizada.
  • Você está definindo um retorno de chamada ou está em algum outro escopo em que já está sendo passado um identificador DependencyProperty e é possível que exista mais de uma propriedade de dependência com a qual talvez você queira interagir nesse escopo. Nesses casos, provavelmente é mais simples chamar SetValue, passando o identificador.

Aplica-se a

Confira também