DependencyObject.SetValue Metódus

Definíció

Névtér:

System.Windows

Szerelvény:

WindowsBase.dll

Beállítja egy függőségi tulajdonság helyi értékét.

Túlterhelések

Name	Description
SetValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság helyi értékét, amelyet a függőségi tulajdonság azonosítója határoz meg.
SetValue(DependencyPropertyKey, Object)	Beállítja egy írásvédett függőség tulajdonság helyi értékét, amelyet a DependencyPropertyKey függőségi tulajdonság azonosítója határoz meg.

SetValue(DependencyProperty, Object)

Beállítja egy függőségi tulajdonság helyi értékét, amelyet a függőségi tulajdonság azonosítója határoz meg.

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)

Paraméterek

dp

DependencyProperty

A beállítandó függőségi tulajdonság azonosítója.

value

Object

Az új helyi érték.

Kivételek

InvalidOperationException

Egy írásvédett függőségi tulajdonságot vagy egy lezárt DependencyObjecttulajdonságot próbált módosítani.

ArgumentException

value nem a megfelelő típus volt regisztrálva a dp tulajdonsághoz.

Megjegyzések

Ha a megadott típus nem egyezik meg az eredetileg regisztrált függőségi tulajdonsághoz deklarált típussal, a rendszer kivételt okoz. A value paramétert mindig a megfelelő típusként kell megadni.

A kivételi feltételeket befolyásolhatja a ValidateValueCallback beállított függőségi tulajdonság függőségi tulajdonságazonosítóján található visszahívás. Ellenkező esetben előfordulhat, hogy a megadott érték nem felel meg az általános típusellenőrzési feltételeknek (például sztringet ad át, ha a natív típus dupla).

SetValue(DependencyPropertyKey, Object)

Beállítja egy írásvédett függőség tulajdonság helyi értékét, amelyet a DependencyPropertyKey függőségi tulajdonság azonosítója határoz meg.

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)

Paraméterek

key

DependencyPropertyKey

A DependencyPropertyKey beállítani kívánt tulajdonság azonosítója.

value

Object

Az új helyi érték.

Példák

Az alábbi példa egy írásvédett függőségi tulajdonságot határoz meg, valamint egy public static readonlyDependencyProperty olyan tulajdonságot, amely a szükséges írásvédettséget biztosítja a tulajdonságfogyasztók számára, valamint a CLR-burkoló lekéréses tartozékát.

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

Megjegyzések

Ez az aláírás általában akkor használatos, ha az egyéni osztályok által meghatározott írásvédett függőségi tulajdonságok értékeit állítja be. SetValue Általában csak a függőségi tulajdonságot regisztráló típusból hívjuk, amely megvalósítja a függőségi tulajdonság meghatározott értékét biztosító belső logikát. További információ: Read-Only Függőség tulajdonságai.

Ha a megadott típus nem egyezik meg az eredetileg regisztrált függőségi tulajdonsághoz deklarált típussal, a rendszer kivételt okoz. A value paramétert mindig a megfelelő típusként kell megadni. A kivételi feltételeket befolyásolhatja a ValidateValueCallback beállított függőségi tulajdonság függőségi tulajdonságazonosítóján található visszahívás.