DependencyProperty Sınıf

Tanım

Stil oluşturma, veri bağlama, animasyon ve devralma gibi yöntemler aracılığıyla ayarlanabilen bir özelliği temsil eder.

public ref class DependencyProperty sealed
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
Devralma
DependencyProperty
Öznitelikler

Açıklamalar

DependencyProperty, Windows Presentation Foundation'da (WPF) aşağıdaki özellikleri destekler:

  • özelliği bir stilde ayarlanabilir. Daha fazla bilgi için bkz. Stil oluşturma ve Şablon Oluşturma.

  • özelliği veri bağlama aracılığıyla ayarlanabilir. Veri bağlama bağımlılık özellikleri hakkında daha fazla bilgi için bkz. Nasıl yapılır: İki Denetimin Özelliklerini Bağlama.

  • özelliği dinamik kaynak başvurusu ile ayarlanabilir. Daha fazla bilgi için bkz. XAML Kaynakları.

  • özelliği, değerini öğe ağacındaki bir üst öğeden otomatik olarak devralabilir. Daha fazla bilgi için bkz. Özellik Değeri Devralma.

  • Özelliği animasyonlu olabilir. Daha fazla bilgi için bkz. Animasyona Genel Bakış.

  • Özelliğin önceki değeri değiştirildiğinde ve özellik değeri zorunlu olduğunda özelliği raporlayabilir. Daha fazla bilgi için bkz. Bağımlılık Özelliği Geri Çağırmaları ve Doğrulama.

  • özelliği, bir özellik değerini değiştirmenin düzen sisteminin bir öğenin görsellerini yeniden derlemesini gerektirip gerektirmemesi gibi bilgileri WPF'ye bildirir.

  • özelliği Visual Studio için WPF Tasarımcısı'nda destek alır. Örneğin, özelliği Özellikler penceresinde düzenlenebilir.

Bağımlılık özellikleri hakkında daha fazla bilgi edinmek için bkz. Bağımlılık Özelliklerine Genel Bakış. Özel türlerinizdeki özelliklerin önceki listedeki özellikleri desteklemesini istiyorsanız, bir bağımlılık özelliği oluşturmanız gerekir. Özel bağımlılık özellikleri oluşturmayı öğrenmek için bkz. Özel Bağımlılık Özellikleri.

Ekli özellik, herhangi bir nesnenin ekli özelliği tanımlayan türe bilgi raporlamasına olanak tanıyan bir özelliktir. WPF'de, DependencyObject'den devralan herhangi bir tür, türün özelliği tanımlayan türden devralıp devralmadığına bakılmaksızın ekli bir özellik kullanabilir. Ekli özellik, XAML dilinin bir özelliğidir. XAML'de ekli bir özellik ayarlamak için ownerTypekullanın.propertyName söz dizimi. İliştirilmiş bir özelliğe örnek olarak DockPanel.Dock özelliği gösterilir. Tüm DependencyObject türlerinde kullanılabilecek bir özellik oluşturmak istiyorsanız, ekli bir özellik oluşturmanız gerekir. Ekli özellikler hakkında daha fazla bilgi edinmek için bkz. Ekli Özelliklere Genel Bakış.

XAML Öznitelik Kullanımı

<object property="dependencyPropertyName"/>  

-veya-

<object property="ownerType.dependencyPropertyName"/>  

-veya-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML Değerleri

dependencyPropertyName
İstenen bağımlılık özelliğinin DependencyProperty.Name belirten bir dize. Özellik varsayılan XML ad alanında değilse bunun önüne xml ad alanı ön eki eklenebilir (ayrıntılar için bkz. WPF XAMLiçin XAML Ad Alanları ve Ad Alanı Eşlemesi.)

ownerType.dependencyPropertyName
Bir bağımlılık özelliğinin sahip türünü belirten dize, nokta (.) ve ardından DependencyProperty.Name. ownerType önünde bir XML ad alanı ön eki de bulunabilir. Bu kullanım, TargetType henüz bilinmediğinden bağlamı ayrıştırmak için bağımlılık özelliğinin sahibinin belirtilmesi gereken geç bağlı stil ve şablonlara özeldir. Daha fazla bilgi için bkz. Stil oluşturma ve Şablon Oluşturma.

attachedPropertyOwnerType .attachedPropertyName
Ekli bir özelliğin sahibini belirten dize, nokta (.) ve ardından ekli özellik adı. attachedPropertyOwnerType önünde bir XML ad alanı ön eki de bulunabilir.

Alanlar

UnsetValue

Özelliğin var olduğunu belirtmek için null yerine WPF özellik sistemi tarafından kullanılan ancak değerinin özellik sistemi tarafından ayarlanmadığını belirten statik bir değer belirtir.

Özellikler

DefaultMetadata

Bağımlılık özelliğinin varsayılan meta verilerini alır.

GlobalIndex

Bağımlılık özelliğini benzersiz olarak tanımlayan dahili olarak oluşturulmuş bir değer alır.

Name

Bağımlılık özelliğinin adını alır.

OwnerType

Bağımlılık özelliğini özellik sistemine kaydeden veya özelliğin sahibi olarak kendisini ekleyen nesnenin türünü alır.

PropertyType

Bağımlılık özelliğinin değeri için kullandığı türü alır.

ReadOnly

Bu DependencyProperty örneği tarafından tanımlanan bağımlılık özelliğinin salt okunur bir bağımlılık özelliği olup olmadığını gösteren bir değer alır.

ValidateValueCallback

Bağımlılık özelliği için değer doğrulama geri çağırmasını alır.

Yöntemler

AddOwner(Type)

Zaten kaydedilmiş bir bağımlılık özelliğinin sahibi olarak başka bir tür ekler.

AddOwner(Type, PropertyMetadata)

Daha önce kaydedilmiş bir bağımlılık özelliğinin sahibi olarak başka bir tür ekler ve sağlanan sahip türünde var olacağı için bağımlılık özelliği için bağımlılık özelliği meta verileri sağlar.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Bu DependencyPropertyiçin bir karma kodu döndürür.

GetMetadata(DependencyObject)

Belirtilen nesne örneğinde var olan bu bağımlılık özelliğinin meta verilerini döndürür.

GetMetadata(DependencyObjectType)

Bu bağımlılık özelliğinin meta verilerini belirtilen türde mevcut olduğundan döndürür.

GetMetadata(Type)

Bu bağımlılık özelliğinin meta verilerini belirtilen varolan bir tür üzerinde mevcut olduğundan döndürür.

GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
IsValidType(Object)

Belirtilen değerin, özgün bağımlılık özellik kaydında sağlanan özellik türüne göre denetlendiği gibi bu bağımlılık özelliğinin türü için kabul edilebilir olup olmadığını belirler.

IsValidValue(Object)

Sağlanan değerin, temel tür denetimi aracılığıyla özellik türü için kabul edilip edilmeyeceğini ve bu tür için izin verilen değer aralığında olup olmadığını belirler.

MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
OverrideMetadata(Type, PropertyMetadata)

Belirtilen türdeki örneklerde mevcut olduğunda bu bağımlılık özelliği için alternatif meta verileri belirtir ve temel türlerden devralındığı için bağımlılık özelliği için var olan meta verileri geçersiz kılınır.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Belirtilen türdeki örneklerde mevcut olduğunda salt okunur bağımlılık özelliği için alternatif meta veriler sağlar ve ilk bağımlılık özelliği kaydında sağlanan meta verileri geçersiz kılma. Özel durum oluşturmamak için salt okunur bağımlılık özelliğinin DependencyPropertyKey geçirmeniz gerekir.

Register(String, Type, Type)

Bir bağımlılık özelliğini belirtilen özellik adı, özellik türü ve sahip türüyle kaydeder.

Register(String, Type, Type, PropertyMetadata)

Bağımlılık özelliğini belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle kaydeder.

Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Bağımlılık özelliğini belirtilen özellik adı, özellik türü, sahip türü, özellik meta verileri ve özellik için değer doğrulama geri çağırmasıyla kaydeder.

RegisterAttached(String, Type, Type)

Belirtilen özellik adı, özellik türü ve sahip türüyle ekli bir özelliği kaydeder.

RegisterAttached(String, Type, Type, PropertyMetadata)

Eklenen özelliği belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle kaydeder.

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Ekli bir özelliği belirtilen özellik türüne, sahip türüne, özellik meta verilerine ve özellik için değer doğrulama geri çağırmaya kaydeder.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Belirtilen özellik türü, sahip türü ve özellik meta verileriyle salt okunur bir ekli özelliği kaydeder.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Belirtilen özellik türü, sahip türü, özellik meta verileri ve doğrulama geri çağırması ile salt okunur ekli bir özelliği kaydeder.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

Belirtilen özellik türü, sahip türü ve özellik meta verileriyle salt okunur bağımlılık özelliğini kaydeder.

RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Belirtilen özellik türü, sahip türü, özellik meta verileri ve bir doğrulama geri çağırması ile salt okunur bağımlılık özelliğini kaydeder.

ToString()

Bağımlılık özelliğinin dize gösterimini döndürür.

Şunlara uygulanır

Ayrıca bkz.