DependencyObject.SetValue Método

public:
 void SetValue(System::Windows::DependencyProperty ^ dp, System::Object ^ value);

public void SetValue (System.Windows.DependencyProperty dp, object value);

member this.SetValue : System.Windows.DependencyProperty * obj -> unit

Public Sub SetValue (dp As DependencyProperty, value As Object)

Parâmetros

Exceções

Comentários

Se o tipo fornecido não corresponder ao tipo declarado para a propriedade de dependência como ela foi registrada originalmente, uma exceção será gerada. O parâmetro value sempre deve ser fornecido como o tipo apropriado.

As condições de exceção são potencialmente influenciadas pelo retorno de chamada ValidateValueCallback que existe no identificador de propriedade de dependência da propriedade de dependência que está sendo definida. Caso contrário, o valor fornecido poderá estar falhando nas condições gerais de verificação de tipo (por exemplo, passando uma cadeia de caracteres quando o tipo nativo for Double).

public:
 void SetValue(System::Windows::DependencyPropertyKey ^ key, System::Object ^ value);

public void SetValue (System.Windows.DependencyPropertyKey key, object value);

member this.SetValue : System.Windows.DependencyPropertyKey * obj -> unit

Public Sub SetValue (key As DependencyPropertyKey, value As Object)

Parâmetros

Exemplos

O exemplo a seguir define uma propriedade de dependência somente leitura, juntamente com uma public static readonlyDependencyProperty que fornece a exposição somente leitura necessária aos consumidores de propriedade e o acessador get para o wrapper CLR.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}

Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

Comentários

Essa assinatura geralmente é usada quando você define valores para propriedades de dependência somente leitura definidas por suas classes personalizadas. Geralmente, SetValue é chamado somente do tipo que registrou essa propriedade de dependência, que implementa a lógica interna que fornece o valor determinado para a propriedade de dependência. Para obter mais informações, consulte Read-Only propriedades de dependência.

Se o tipo fornecido não corresponder ao tipo declarado para a propriedade de dependência como ela foi registrada originalmente, uma exceção será gerada. O parâmetro value sempre deve ser fornecido como o tipo apropriado. As condições de exceção são potencialmente influenciadas pelo retorno de chamada ValidateValueCallback que existe no identificador de propriedade de dependência da propriedade de dependência que está sendo definida.