DependencyObject.SetValue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta il valore locale di una proprietà di dipendenza.
Overload
SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. |
SetValue(DependencyPropertyKey, Object) |
Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. |
SetValue(DependencyProperty, Object)
Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza.
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)
Parametri
Identificatore della proprietà di dipendenza da impostare.
- value
- Object
Nuovo valore locale.
Eccezioni
Tentativo di modificare una proprietà di dipendenza di sola lettura o una proprietà in un DependencyObjectsealed.
value
non era il tipo corretto registrato per la proprietà dp
.
Commenti
Se il tipo specificato non corrisponde al tipo dichiarato per la proprietà di dipendenza come originariamente registrato, viene generata un'eccezione. Il parametro value
deve essere sempre fornito come tipo appropriato.
Le condizioni di eccezione sono potenzialmente influenzate dal callback ValidateValueCallback presente nell'identificatore della proprietà di dipendenza della proprietà di dipendenza da impostare. In caso contrario, il valore specificato potrebbe non riuscire a verificare le condizioni generali di controllo dei tipi, ad esempio passando una stringa quando il tipo nativo è Double.
Si applica a
SetValue(DependencyPropertyKey, Object)
Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.
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)
Parametri
Identificatore DependencyPropertyKey della proprietà da impostare.
- value
- Object
Nuovo valore locale.
Esempio
Nell'esempio seguente viene definita una proprietà di dipendenza di sola lettura, insieme a un public static readonly
DependencyProperty che fornisce l'esposizione di sola lettura necessaria ai consumer di proprietà e alla funzione di accesso get per il 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
Commenti
Questa firma viene in genere usata quando si impostano valori per le proprietà di dipendenza di sola lettura definite dalle classi personalizzate. In genere, SetValue viene chiamato solo dal tipo che ha registrato la proprietà di dipendenza, che implementa la logica interna che fornisce il valore determinato per la proprietà di dipendenza. Per altre informazioni, vedere Read-Only Proprietà di dipendenza.
Se il tipo specificato non corrisponde al tipo dichiarato per la proprietà di dipendenza come originariamente registrato, viene generata un'eccezione. Il parametro value
deve essere sempre fornito come tipo appropriato. Le condizioni di eccezione sono potenzialmente influenzate dal callback ValidateValueCallback presente nell'identificatore della proprietà di dipendenza della proprietà di dipendenza da impostare.