Compartir a través de


DependencyObject.SetValue(DependencyProperty, Object) Método

Definición

Establece el valor local de una propiedad de dependencia en 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

Identificador de la propiedad de dependencia que se va a establecer.

value
Object

Platform::Object

IInspectable

Nuevo valor local.

Comentarios

Si el tipo de valor proporcionado no coincide con el tipo declarado para la propiedad de dependencia tal como se registró originalmente, se produce una excepción.

No todas las propiedades de Windows Runtime que usa XAML son propiedades de dependencia. Un identificador DependencyProperty debe existir y debe estar disponible como una propiedad pública de un objeto propietario, normalmente el objeto que registró la propiedad.

En el caso del código de usuario de la aplicación, la llamada a SetValue no suele ser necesaria. Normalmente, una propiedad de dependencia Windows Runtime o una propiedad de dependencia personalizada tiene una propiedad convencional que la encapsula y simplemente puede establecer el valor de la propiedad a través de un uso de puntos convencional. Los casos en los que puede seguir usando SetValue son:

  • Va a definir una propiedad de dependencia personalizada. Llamará a SetValue como parte de la definición de su propio descriptor de acceso de conjunto de propiedades para un uso de propiedad convencional. Para obtener más información, consulta Propiedades de dependencia personalizadas.
  • Está definiendo una devolución de llamada o está en algún otro ámbito en el que ya se pasa un identificador DependencyProperty y es posible que haya más de una propiedad de dependencia con la que quiera interactuar en ese ámbito. En estos casos, probablemente sea más sencillo llamar a SetValue, pasando el identificador.

Se aplica a

Consulte también