DependencyObject.SetValue Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

WindowsBase.dll

Ustawia wartość lokalną właściwości zależności.

Przeciążenia

SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności.
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określoną przez identyfikator DependencyPropertyKey właściwości zależności.

SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności.

C#

public void SetValue(System.Windows.DependencyProperty dp, object value);

Parametry

dp

DependencyProperty

Identyfikator właściwości zależności do ustawienia.

value

Object

Nowa wartość lokalna.

Wyjątki

InvalidOperationException

Podjęto próbę zmodyfikowania właściwości zależności tylko do odczytu lub właściwości na zapieczętowanym DependencyObject.

ArgumentException

value nie był poprawnym typem zarejestrowanym dla właściwości dp.

Uwagi

Jeśli podany typ nie jest zgodny z typem zadeklarowanym dla właściwości zależności, ponieważ został pierwotnie zarejestrowany, zgłaszany jest wyjątek. Parametr value należy zawsze podać jako odpowiedni typ.

Warunki wyjątku mogą mieć wpływ na wywołanie zwrotne ValidateValueCallback, które istnieje na identyfikator właściwości zależności ustawianej właściwości zależności. W przeciwnym razie podana wartość może zakończyć się niepowodzeniem ogólnych warunków sprawdzania typów (na przykład przekazanie ciągu, gdy typ natywny to Double).

SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu określoną przez identyfikator DependencyPropertyKey właściwości zależności.

C#

public void SetValue(System.Windows.DependencyPropertyKey key, object value);

Parametry

key

DependencyPropertyKey

Identyfikator DependencyPropertyKey właściwości do ustawienia.

value

Object

Nowa wartość lokalna.

Przykłady

W poniższym przykładzie zdefiniowano właściwość zależności tylko do odczytu wraz z public static readonlyDependencyProperty, która zapewnia niezbędną ekspozycję tylko do odczytu dla odbiorców właściwości, oraz metodę uzyskiwania dostępu do otoki CLR.

C#

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); }
}

Uwagi

Ten podpis jest zwykle używany podczas ustawiania wartości właściwości zależności tylko do odczytu zdefiniowanych przez klasy niestandardowe. Ogólnie rzecz biorąc, SetValue jest wywoływana tylko z typu, który zarejestrował tę właściwość zależności, która implementuje wewnętrzną logikę, która zapewnia określoną wartość dla właściwości zależności. Aby uzyskać więcej informacji, zobacz właściwości zależności Read-Only.

Jeśli podany typ nie jest zgodny z typem zadeklarowanym dla właściwości zależności, ponieważ został pierwotnie zarejestrowany, zgłaszany jest wyjątek. Parametr value należy zawsze podać jako odpowiedni typ. Warunki wyjątku mogą mieć wpływ na wywołanie zwrotne ValidateValueCallback, które istnieje na identyfikator właściwości zależności ustawianej właściwości zależności.