DependencyObject.SetValue Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee stelt u de lokale waarde van een afhankelijkheidseigenschap in.
Overloads
| Name | Description |
|---|---|
| SetValue(DependencyProperty, Object) |
Hiermee stelt u de lokale waarde van een afhankelijkheidseigenschap in, die is opgegeven door de id van de afhankelijkheidseigenschap. |
| SetValue(DependencyPropertyKey, Object) |
Hiermee stelt u de lokale waarde van een alleen-lezen afhankelijkheidseigenschap in, die is opgegeven door de DependencyPropertyKey id van de afhankelijkheidseigenschap. |
SetValue(DependencyProperty, Object)
Hiermee stelt u de lokale waarde van een afhankelijkheidseigenschap in, die is opgegeven door de id van de afhankelijkheidseigenschap.
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 -> unitPublic Sub SetValue (dp As DependencyProperty, value As Object)Parameters
De id van de afhankelijkheidseigenschap die moet worden ingesteld.
- value
- Object
De nieuwe lokale waarde.
Uitzonderingen
Er is geprobeerd een alleen-lezen afhankelijkheidseigenschap of een eigenschap op een verzegelde DependencyObjecteigenschap te wijzigen.
value was niet het juiste type als geregistreerd voor de dp eigenschap.
Opmerkingen
Als het opgegeven type niet overeenkomt met het type dat is gedeclareerd voor de afhankelijkheidseigenschap zoals het oorspronkelijk is geregistreerd, wordt er een uitzondering gegenereerd. De value parameter moet altijd worden opgegeven als het juiste type.
De uitzonderingsvoorwaarden worden mogelijk beïnvloed door de ValidateValueCallback callback die bestaat op de id van de afhankelijkheidseigenschap van de afhankelijkheidseigenschap die wordt ingesteld. Anders kan de opgegeven waarde mislukken in algemene voorwaarden voor typecontrole (bijvoorbeeld door een tekenreeks door te geven wanneer het systeemeigen type double is).
Van toepassing op
SetValue(DependencyPropertyKey, Object)
Hiermee stelt u de lokale waarde van een alleen-lezen afhankelijkheidseigenschap in, die is opgegeven door de DependencyPropertyKey id van de afhankelijkheidseigenschap.
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 -> unitPublic Sub SetValue (key As DependencyPropertyKey, value As Object)Parameters
De DependencyPropertyKey id van de eigenschap die moet worden ingesteld.
- value
- Object
De nieuwe lokale waarde.
Voorbeelden
In het volgende voorbeeld wordt een alleen-lezen-afhankelijkheidseigenschap gedefinieerd, samen met een public static readonlyDependencyProperty eigenschap die de benodigde alleen-lezenblootstelling biedt aan gebruikers van eigenschappen en de get-accessor voor de CLR-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
Opmerkingen
Deze handtekening wordt over het algemeen gebruikt wanneer u waarden instelt voor eigenschappen van alleen-lezenafhankelijkheid die zijn gedefinieerd door uw aangepaste klassen. Over het algemeen SetValue wordt alleen aangeroepen van het type dat die afhankelijkheidseigenschap heeft geregistreerd, waarmee de interne logica wordt geïmplementeerd die de vastgestelde waarde voor de afhankelijkheidseigenschap levert. Zie Read-Only Eigenschappen van afhankelijkheden voor meer informatie.
Als het opgegeven type niet overeenkomt met het type dat is gedeclareerd voor de afhankelijkheidseigenschap zoals het oorspronkelijk is geregistreerd, wordt er een uitzondering gegenereerd. De value parameter moet altijd worden opgegeven als het juiste type. De uitzonderingsvoorwaarden worden mogelijk beïnvloed door de ValidateValueCallback callback die bestaat op de id van de afhankelijkheidseigenschap van de afhankelijkheidseigenschap die wordt ingesteld.