DependencyObject.SetValue Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Bağımlılık özelliğinin yerel değerini ayarlar.

Aşırı Yüklemeler

SetValue(DependencyProperty, Object)	Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar.
SetValue(DependencyPropertyKey, Object)	Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar.

SetValue(DependencyProperty, Object)

Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar.

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)

Parametreler

dp

DependencyProperty

Ayarlanacağı bağımlılık özelliğinin tanımlayıcısı.

value

Object

Yeni yerel değer.

Özel durumlar

InvalidOperationException

Salt okunur bağımlılık özelliğini veya korumalı bir üzerindeki bir özelliği değiştirmeye çalışıldı DependencyObject.

ArgumentException

value özelliği için dp kayıtlı doğru tür değildi.

Açıklamalar

Sağlanan tür, başlangıçta kaydedildiği gibi bağımlılık özelliği için bildirilen türle eşleşmiyorsa, bir özel durum oluşturulur. value Parametresi her zaman uygun tür olarak sağlanmalıdır.

Özel durum koşulları, ayarlanan bağımlılık özelliğinin ValidateValueCallback bağımlılık özellik tanımlayıcısı üzerinde var olan geri çağırmadan etkilenmiş olabilir. Aksi takdirde, sağlanan değer genel tür denetimi koşullarını (örneğin, yerel tür Double olduğunda dize geçirme) başarısız oluyor olabilir.

SetValue(DependencyPropertyKey, Object)

Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar.

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)

Parametreler

key

DependencyPropertyKey

DependencyPropertyKey Ayarlanacağı özelliğin tanımlayıcısı.

value

Object

Yeni yerel değer.

Örnekler

Aşağıdaki örnek, özellik tüketicilerine gerekli salt okunur açıklığı sağlayan bir public static readonlyDependencyProperty ile birlikte salt okunur bağımlılık özelliğini ve CLR sarmalayıcısı için get erişimcisini tanımlar.

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

Açıklamalar

Bu imza genellikle özel sınıflarınız tarafından tanımlanan salt okunur bağımlılık özellikleri için değerler ayarladığınızda kullanılır. Genellikle, SetValue yalnızca bağımlılık özelliği için belirlenen değeri sağlayan iç mantığı uygulayan bağımlılık özelliğini kaydeden türden çağrılır. Daha fazla bilgi için bkz. Salt Okunur Bağımlılık Özellikleri.

Sağlanan tür, başlangıçta kaydedildiği gibi bağımlılık özelliği için bildirilen türle eşleşmiyorsa, bir özel durum oluşturulur. value Parametresi her zaman uygun tür olarak sağlanmalıdır. Özel durum koşulları, ayarlanan bağımlılık özelliğinin ValidateValueCallback bağımlılık özellik tanımlayıcısı üzerinde var olan geri çağırmadan etkilenmiş olabilir.