DependencyProperty Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows

Bütünleştirilmiş Kod:: WindowsBase.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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: Object
DependencyProperty

Öznitelikler: TypeConverterAttribute

Açıklamalar

ADependencyProperty, Windows Presentation Foundation 'de (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 bir 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 gerektirmediği gibi bilgileri WPF'ye bildirir.
özelliği Visual Studio için WPF Tasarımcısı'nda destek alır. Örneğin, özellik Ö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ını sağlayan bir özelliktir. WPF'de, öğesini DependencyObject 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 ownerType değerini kullanın. propertyName söz dizimi. Ekli özelliğe örnek olarak özelliği gösterilir DockPanel.Dock . Tüm DependencyObject türlerde kullanılabilecek bir özellik oluşturmak istiyorsanız, ekli bir özellik oluşturmanız gerekir. Ekli özellikler ve bunların nasıl oluşturulacağı 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ğini belirten DependencyProperty.Name 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 XAML için XAML Ad Alanları ve Ad Alanı Eşlemesi.)

ownerType.dependencyPropertyName
Bağımlılık özelliğinin sahip türünü belirten bir dize, nokta (.) ve ardından öğesini DependencyProperty.Namebelirtir. ownerType öncesinde bir XML ad alanı ön eki de bulunabilir. Bu kullanım özellikle geç bağlanan stiller ve şablonlar içindir ve burada bağımlılık özelliğinin sahibi bağlamı ayrıştırmak için belirtilmelidir çünkü TargetType henüz bilinmemektedir. Daha fazla bilgi için bkz. Stil oluşturma ve Şablon Oluşturma.

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

Alanlar

UnsetValue

Özelliğin var olduğunu belirtmek yerine null WPF özellik sistemi tarafından kullanılan ancak özellik sistemi tarafından ayarlanan değerine sahip olmayan bir statik 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şturulan bir değeri 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 örnek 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)	Önceden 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 bir tür üzerinde varolduğundan döndürür.
GetMetadata(Type)	Bu bağımlılık özelliğinin meta verilerini belirtilen var olan bir tür üzerinde var olduğundan döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsValidType(Object)	Belirtilen değerin, özgün bağımlılık özelliği kaydında sağlanan özellik türüne göre denetlendiği şekilde 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 Objectöğesinin sığ 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 bir 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ılarak. Özel durum oluşturmamak için salt okunur bağımlılık özelliğini geçirmeniz DependencyPropertyKey gerekir.
Register(String, Type, Type)	Belirtilen özellik adı, özellik türü ve sahip türüyle bir bağımlılık özelliğini kaydeder.
Register(String, Type, Type, PropertyMetadata)	Bir 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)	Bir 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ü ile ekli bir özelliği kaydeder.
RegisterAttached(String, Type, Type, PropertyMetadata)	Belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileriyle ekli bir özelliği kaydeder.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Özelliğin belirtilen özellik türü, sahip türü, özellik meta verileri ve değer doğrulama geri çağırmasıyla ekli bir özelliği 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ıyla salt okunur bir ekli ö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 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