DependencyObject.SetValue Método

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
WindowsBase.dll

Define o valor local de uma propriedade de dependência.

Sobrecargas

Name Description
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência.
SetValue(DependencyPropertyKey, Object)

Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência.

SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência.

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

dp
DependencyProperty

O identificador da propriedade de dependência a definir.

value
Object

O novo valor local.

Exceções

InvalidOperationException

Tentou modificar uma propriedade de dependência apenas de leitura, ou uma propriedade num DependencyObject.

ArgumentException

value não era o tipo correto registado para a dp propriedade.

Observações

Se o tipo fornecido não corresponder ao tipo declarado para a propriedade de dependência tal como foi originalmente registada, é lançada uma exceção. O value parâmetro deve ser sempre fornecido como do tipo apropriado.

As condições de exceção são potencialmente influenciadas pelo ValidateValueCallback callback que existe no identificador da propriedade de dependência da propriedade de dependência que está a ser definida. Caso contrário, o valor fornecido pode estar a falhar em condições gerais de verificação de tipos (por exemplo, passar uma cadeia quando o tipo nativo é Double).

Aplica-se a

SetValue(DependencyPropertyKey, Object)

Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência.

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

key
DependencyPropertyKey

O DependencyPropertyKey identificador da propriedade a definir.

value
Object

O novo valor local.

Exemplos

O exemplo seguinte define uma propriedade de dependência apenas de leitura, juntamente com a public static readonlyDependencyProperty que fornece a exposição necessária a apenas leitura aos consumidores imobiliários, e o acessório 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

Observações

Esta assinatura é geralmente usada quando defines valores para propriedades de dependência de apenas leitura definidas pelas tuas classes personalizadas. Geralmente, SetValue é chamada apenas pelo tipo que registou essa propriedade de dependência, que implementa a lógica interna que fornece o valor determinado para a propriedade de dependência. Para 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 tal como foi originalmente registada, é lançada uma exceção. O value parâmetro deve ser sempre fornecido como do tipo apropriado. As condições de exceção são potencialmente influenciadas pelo ValidateValueCallback callback que existe no identificador da propriedade de dependência da propriedade de dependência que está a ser definida.

Aplica-se a