DependencyObject.SetValue Yöntem

Tanım

Bağımlılık özelliğinin yerel değerini ayarlar.Sets the local value of a dependency property.

Aşırı Yüklemeler

SetValue(DependencyProperty, Object)

Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir Dependency özelliğinin yerel değerini ayarlar.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object)

Bir salt okuma bağımlılığı özelliğinin yerel değerini, DependencyPropertyKey bağımlılık özelliğinin tanımlayıcısıyla belirtilen şekilde ayarlar.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object)

Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir Dependency özelliğinin yerel değerini ayarlar.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)

Parametreler

dp
DependencyProperty

Ayarlanacak bağımlılık özelliğinin tanımlayıcısı.The identifier of the dependency property to set.

value
Object

Yeni yerel değer.The new local value.

Özel durumlar

Salt okunurdur bir bağımlılık özelliğini değiştirme girişiminde bulunuldu veya korumalı bir özellik DependencyObject .Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value özelliği için kayıtlı olan doğru türde değildi dp .value was not the correct type as registered for the dp property.

Açıklamalar

Belirtilen tür, ilk kaydedildiği sırada bağımlılık özelliği için belirtilen türle eşleşmezse, bir özel durum oluşturulur.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. valueParametresi her zaman uygun tür olarak sağlanmalıdır.The value parameter should always be provided as the appropriate type.

Özel durum koşulları, ValidateValueCallback ayarlanan bağımlılık özelliğinin bağımlılık özelliği tanımlayıcıda bulunan geri çağırma tarafından etkilenebilir.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. Aksi halde, belirtilen değer genel tür denetimi koşullarına (örneğin, yerel tür çift olduğunda bir dize geçirerek) başarısız olabilir.Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

Şunlara uygulanır

Ürün Introduced

SetValue(DependencyPropertyKey, Object)

Bir salt okuma bağımlılığı özelliğinin yerel değerini, DependencyPropertyKey bağımlılık özelliğinin tanımlayıcısıyla belirtilen şekilde ayarlar.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)

Parametreler

key
DependencyPropertyKey

DependencyPropertyKeyAyarlanacak özelliğin tanımlayıcısı.The DependencyPropertyKey identifier of the property to set.

value
Object

Yeni yerel değer.The new local value.

Örnekler

Aşağıdaki örnek, bir salt okunurdur, public static readonly DependencyProperty özellik tüketicilerine ve sarmalayıcı için al erişimcisine, gerekli salt okunurdur pozlamayı sağlayan bir salt okunurdur 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

Açıklamalar

Bu imza genellikle özel sınıflarınız tarafından tanımlanan salt yazılır bağımlılık özellikleri için değerler ayarladığınızda kullanılır.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. Genellikle, bağımlılık SetValue özelliği için belirlenen değeri sağlayan iç mantığı uygulayan, yalnızca bu bağımlılık özelliğine kayıtlı olan türden çağrılır.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. Daha fazla bilgi için bkz. salt okuma bağımlılığı özellikleri.For more information, see Read-Only Dependency Properties.

Belirtilen tür, ilk kaydedildiği sırada bağımlılık özelliği için belirtilen türle eşleşmezse, bir özel durum oluşturulur.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. valueParametresi her zaman uygun tür olarak sağlanmalıdır.The value parameter should always be provided as the appropriate type. Özel durum koşulları, ValidateValueCallback ayarlanan bağımlılık özelliğinin bağımlılık özelliği tanımlayıcıda bulunan geri çağırma tarafından etkilenebilir.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

Şunlara uygulanır

Ürün Introduced