DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue Method

Definição

Define o valor local de uma propriedade de dependência.Sets the local value of a dependency property.

Sobrecargas

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

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 DependencyProperty DependencyProperty DependencyProperty

O identificador da propriedade de dependência a ser definida.The identifier of the dependency property to set.

value
Object Object Object Object

O novo valor local.The new local value.

Exceções

Houve uma tentativa de modificar uma propriedade de dependência somente leitura ou uma propriedade em um DependencyObject lacrado.Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value não era do tipo correto conforme registrado para a propriedade dp.value was not the correct type as registered for the dp property.

Comentários

Se o tipo fornecido não corresponder ao tipo declarado para a propriedade de dependência conforme foi registrado originalmente, uma exceção será lançada.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. O value parâmetro sempre deve ser fornecido como o tipo apropriado.The value parameter should always be provided as the appropriate type.

As condições de exceção são potencialmente influenciadas ValidateValueCallback pelo retorno de chamada que existe no identificador da propriedade de dependência da propriedade de dependência que está sendo definida.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. Caso contrário, o valor fornecido pode estar falhando em condições gerais de verificação de tipo (por exemplo, passando uma cadeia de caracteres quando o tipo nativo é duplo).Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

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 DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

O identificador DependencyPropertyKey da propriedade a ser definido.The DependencyPropertyKey identifier of the property to set.

value
Object Object Object Object

O novo valor local.The new local value.

Exemplos

O exemplo a seguir define uma propriedade de dependência somente leitura, juntamente com public static readonly um DependencyProperty que fornece a exposição somente leitura necessária para os consumidores de propriedade e o acessador get para o CLRCLR wrapper.The following example defines a read-only dependency property, along with a public static readonly DependencyProperty that provides necessary read-only exposure to property consumers, and the get accessor for the CLRCLR wrapper.

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 que são definidas por suas classes personalizadas.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. Geralmente, SetValue é chamado apenas 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.Generally, SetValue is called only from the type that registered that dependency property, which implements the internal logic that provides the determined value for the dependency property. Para obter mais informações, consulte Propriedades de dependência somente leitura.For more information, see Read-Only Dependency Properties.

Se o tipo fornecido não corresponder ao tipo declarado para a propriedade de dependência conforme foi registrado originalmente, uma exceção será lançada.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. O value parâmetro sempre deve ser fornecido como o tipo apropriado.The value parameter should always be provided as the appropriate type. As condições de exceção são potencialmente influenciadas ValidateValueCallback pelo retorno de chamada que existe no identificador da propriedade de dependência da propriedade de dependência que está sendo definida.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

Aplica-se a