DependencyObject.SetValue Methode
Definition
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest.Sets the local value of a dependency property.
Überlädt
SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.Sets the local value of a dependency property, specified by its dependency property identifier. |
SetValue(DependencyPropertyKey, Object) |
Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property. |
SetValue(DependencyProperty, Object)
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.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)
Parameter
Der Bezeichner der festzulegenden Abhängigkeitseigenschaft.The identifier of the dependency property to set.
- value
- Object
Der neue lokale Wert.The new local value.
Ausnahmen
Es wurde versucht, eine schreibgeschützte Abhängigkeitseigenschaft oder eine Eigenschaft eines versiegelten DependencyObject zu ändern.Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.
value
hatte nicht den richtigen Typ, wie er für die dp
-Eigenschaft registriert ist.value
was not the correct type as registered for the dp
property.
Hinweise
Wenn der angegebene Typ nicht mit dem Typ identisch ist, der für die Abhängigkeits Eigenschaft deklariert wurde, weil er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst.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. Der- value
Parameter sollte immer als geeigneter Typ angegeben werden.The value
parameter should always be provided as the appropriate type.
Die Ausnahmebedingungen werden potenziell von dem ValidateValueCallback Rückruf beeinflusst, der im Bezeichner der Abhängigkeits Eigenschaft für die festgelegte Abhängigkeits Eigenschaft vorhanden ist.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. Andernfalls können bei dem bereitgestellten Wert allgemeine Typüberprüfungen fehlschlagen (z. b. das Übergeben einer Zeichenfolge, wenn der Native Typ Double ist).Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).
Gilt für:
SetValue(DependencyPropertyKey, Object)
Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.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)
Parameter
Der DependencyPropertyKey-Bezeichner der festzulegenden Eigenschaft.The DependencyPropertyKey identifier of the property to set.
- value
- Object
Der neue lokale Wert.The new local value.
Beispiele
Im folgenden Beispiel wird eine schreibgeschützte Abhängigkeits Eigenschaft sowie eine definiert, die die erforderliche schreibgeschützte verfügbar machung public static readonly
DependencyProperty für eigenschaftenconsumer und den Get-Accessor für den Wrapper bereitstellt CLRCLR .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
Hinweise
Diese Signatur wird in der Regel verwendet, wenn Sie Werte für schreibgeschützte Abhängigkeits Eigenschaften festlegen, die von Ihren benutzerdefinierten Klassen definiert werden.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. Im allgemeinen SetValue wird nur von dem Typ aufgerufen, der diese Abhängigkeits Eigenschaft registriert hat, die die interne Logik implementiert, die den festgelegten Wert für die Abhängigkeits Eigenschaft bereitstellt.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. Weitere Informationen finden Sie unter Schreibgeschützte Abhängigkeitseigenschaften.For more information, see Read-Only Dependency Properties.
Wenn der angegebene Typ nicht mit dem Typ identisch ist, der für die Abhängigkeits Eigenschaft deklariert wurde, weil er ursprünglich registriert wurde, wird eine Ausnahme ausgelöst.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. Der- value
Parameter sollte immer als geeigneter Typ angegeben werden.The value
parameter should always be provided as the appropriate type. Die Ausnahmebedingungen werden potenziell von dem ValidateValueCallback Rückruf beeinflusst, der im Bezeichner der Abhängigkeits Eigenschaft für die festgelegte Abhängigkeits Eigenschaft vorhanden ist.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.