DependencyProperty Sınıf

Tanım

Stil, veri bağlama, animasyon ve devralma gibi yöntemler aracılığıyla ayarlanabilir bir özelliği temsil eder.Represents a property that can be set through methods such as, styling, data binding, animation, and inheritance.

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

Açıklamalar

DependencyProperty, İçinde aşağıdaki özellikleri destekler Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) :A DependencyProperty supports the following capabilities in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):

  • Özelliği bir stilde ayarlanabilir.The property can be set in a style. Daha fazla bilgi için bkz. Stil oluşturma ve şablonoluşturma.For more information, see Styling and Templating.

  • Özelliği, veri bağlama aracılığıyla ayarlanabilir.The property can be set through data binding. Veri bağlama bağımlılığı özellikleri hakkında daha fazla bilgi için bkz. nasıl yapılır: Iki denetimin özelliklerini bağlama.For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • Özelliği, dinamik bir kaynak başvurusuyla ayarlanabilir.The property can be set with a dynamic resource reference. Daha fazla bilgi için bkz. xaml kaynakları.For more information, see XAML Resources.

  • Özelliği, değerini öğe ağacındaki bir üst öğeden otomatik olarak alabilir.The property can inherit its value automatically from a parent element in the element tree. Daha fazla bilgi için bkz. özellik değeri devralma.For more information, see Property Value Inheritance.

  • Özelliği canlandırılabilirler.The property can be animated. Daha fazla bilgi için bkz. animasyon genel bakış.For more information, see Animation Overview.

  • Özelliği, özelliğin önceki değeri değiştirildiğinde ve özellik değeri zorlanamadığında rapor verebilir.The property can report when the previous value of the property has been changed and the property value can be coerced. Daha fazla bilgi için bkz. bağımlılık özelliği geri çağırmaları ve doğrulama.For more information, see Dependency Property Callbacks and Validation.

  • Özelliği WPFWPF , bir özellik değerinin değiştirilmesinin, düzen sisteminin bir öğenin görsellerini yeniden oluşturmak için gerekli olup olmadığı gibi bilgileri öğesine bildirir.The property reports information to WPFWPF, such as whether changing a property value should require the layout system to recompose the visuals for an element.

  • Özelliği ' de desteği alır Visual Studio için WPF TasarımcısıWPF Designer for Visual Studio .The property receives support in the Visual Studio için WPF TasarımcısıWPF Designer for Visual Studio. Örneğin, özelliği Özellikler penceresinde düzenlenebilir.For example, the property can be edited in the Properties window.

Bağımlılık özellikleri hakkında daha fazla bilgi için bkz. bağımlılık özelliklerine genel bakış.To learn more about dependency properties, see Dependency Properties Overview. Özel türlerinizin özelliklerinin önceki listede yer alan özellikleri desteklemesini istiyorsanız, bir bağımlılık özelliği oluşturmanız gerekir.If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. Özel bağımlılık özellikleri oluşturmayı öğrenmek için bkz. Özel bağımlılık özellikleri.To learn how to create custom dependency properties, see Custom Dependency Properties.

İliştirilmiş bir özellik, herhangi bir nesnenin, ekli özelliği tanımlayan türe bilgi rapor etmesini sağlayan bir özelliktir.An attached property is a property that enables any object to report information to the type that defines the attached property. ' De WPFWPF , öğesinden devralan herhangi bir tür, DependencyObject türün özelliği tanımlayan türden devralınmadığına bakılmaksızın iliştirilmiş bir özelliği kullanabilir.In WPFWPF, any type that inherits from DependencyObject can use an attached property regardless of whether the type inherits from the type that defines the property. İliştirilmiş bir özellik, dilin bir özelliğidir XAMLXAML .An attached property is a feature of the XAMLXAML language. İçindeki iliştirilmiş bir özelliği ayarlamak için XAMLXAML , OwnerTypekullanın.* propertyName* sözdizimi.To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. İliştirilmiş özelliğe bir örnek, DockPanel.Dock özelliktir.An example of an attached property is the DockPanel.Dock property. Tüm türlerde kullanılabilecek bir özellik oluşturmak isterseniz DependencyObject , ekli bir özellik oluşturmanız gerekir.If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. Ekli Özellikler hakkında daha fazla bilgi edinmek için, bkz. ekli özelliklere genel bakış.To learn more about attached properties, including how to create them, see Attached Properties Overview.

XAML Öznitelik KullanımıXAML Attribute Usage

<object property="dependencyPropertyName"/>  

-veya--or-

<object property="ownerType.dependencyPropertyName"/>  

-veya--or-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML DeğerleriXAML Values

dependencyPropertyName
DependencyProperty.Nameİstenen bağımlılık özelliğini belirten bir dize.A string that specifies the DependencyProperty.Name of the desired dependency property. Özellik varsayılan XML ad alanında değilse, bu, öncesinde bir XML ad alanı ön eki olabilir (Ayrıntılar için bkz. WPF XAML Için xaml ad alanları ve ad alanı eşlemesi.)This can be preceded by an XML namespace prefix if the property is not in the default XML namespace (for details, see XAML Namespaces and Namespace Mapping for WPF XAML.)

ownerType.dependencyPropertyNameownerType.dependencyPropertyName
Dependency özelliğinin sahip türünü belirten bir dize, nokta (.), daha sonra DependencyProperty.Name .A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType Bundan önce bir XML ad alanı ön eki de olabilir.ownerType can also be preceded by an XML namespace prefix. Bu kullanım, daha önce bilinmeyen olmadığından, bağımlılık özelliği sahibinin içerik ayrıştırma için belirtilmesi gereken, geç bağlama stilleri ve şablonları için özel olarak tasarlanmıştır TargetType .This usage is particular to late-bound styles and templates, where the owner of the dependency property must be specified for parsing context because the TargetType is not yet known. Daha fazla bilgi için bkz. Stil oluşturma ve şablonoluşturma.For more information, see Styling and Templating.

attachedPropertyOwnerType .attachedPropertyOwnerType . attachedPropertyName
İliştirilmiş özelliğin sahibini belirten bir dize, nokta (.), sonra eklenen özellik adı.A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType Bundan önce bir XML ad alanı ön eki de olabilir.attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

Alanlar

UnsetValue

Özelliğin var olduğunu göstermek yerine özellik sistemi tarafından kullanılan statik bir değeri belirtir WPFWPF null , ancak özelliğin değeri özellik sistemi tarafından ayarlanmış değildir.Specifies a static value that is used by the WPFWPF property system rather than null to indicate that the property exists, but does not have its value set by the property system.

Özellikler

DefaultMetadata

Bağımlılık özelliğinin varsayılan meta verilerini alır.Gets the default metadata of the dependency property.

GlobalIndex

Bağımlılık özelliğini benzersiz bir şekilde tanımlayan, dahili olarak oluşturulmuş bir değer alır.Gets an internally generated value that uniquely identifies the dependency property.

Name

Bağımlılık özelliğinin adını alır.Gets the name of the dependency property.

OwnerType

Bağımlılık özelliğini özellik sistemiyle kaydettiğiniz nesnenin türünü alır veya kendisini özelliğin sahibi olarak eklemiştir.Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType

Bağımlılık özelliğinin değeri için kullandığı türü alır.Gets the type that the dependency property uses for its value.

ReadOnly

Bu örnek tarafından tanımlanan bağımlılık özelliğinin DependencyProperty salt okunurdur bir bağımlılık özelliği olup olmadığını gösteren bir değer alır.Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback

Bağımlılık özelliği için değer doğrulama geri aramasını alır.Gets the value validation callback for the dependency property.

Yöntemler

AddOwner(Type)

Zaten kaydedilmiş olan Dependency özelliğinin sahibi olarak başka bir tür ekler.Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata)

Zaten kayıtlı olan bir bağımlılık özelliğinin sahibi olarak başka bir tür ekler ve sağlanan sahip türü üzerinde mevcut olacağı için bağımlılık özelliği için bağımlılık özelliği meta verileri sağlar.Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

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

Bunun için bir karma kod döndürür DependencyProperty .Returns a hash code for this DependencyProperty.

GetMetadata(DependencyObject)

Bu bağımlılık özelliği için belirtilen nesne örneğinde var olan meta verileri döndürür.Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType)

Bu bağımlılık özelliği için belirtilen bir tür üzerinde mevcut olduğundan meta verileri döndürür.Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type)

Belirtilen varolan bir tür üzerinde mevcut olduğundan, bu bağımlılık özelliği için meta verileri döndürür.Returns the metadata for this dependency property as it exists on a specified existing type.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

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

Özgün bağımlılık özelliği kaydında belirtilen özellik türüne göre denetlenen şekilde, belirtilen değerin bu bağımlılık özelliğinin türü için kabul edilebilir olup olmadığını belirler.Determines whether a specified value is acceptable for this dependency property's type, as checked against the property type provided in the original dependency property registration.

IsValidValue(Object)

Verilen değerin temel tür denetlemesi aracılığıyla Özellik türü için kabul edilip edilmeyeceğini ve ayrıca bu tür için izin verilen değer aralığının içindeyse büyük olasılıkla ne olduğunu belirler.Determines whether the provided value is accepted for the type of property through basic type checking, and also potentially if it is within the allowed range of values for that type.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

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

Bu bağımlılık özelliği için, belirtilen bir türün örneklerinde mevcut olduğunda, bağımlılık özelliği için varolan meta verileri temel türlerden devraldığından geçersiz kılan diğer meta verileri belirtir.Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

, İlk bağımlılık özelliği kaydında sağlanan meta verileri geçersiz kılan, belirtilen bir türün örneklerinde mevcut olduğunda salt okunurdur.Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. DependencyPropertyKeyBir özel durumun oluşmasını önlemek için salt okuma bağımlılığı özelliği için ' i geçirmeniz gerekir.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

Register(String, Type, Type)

Belirtilen özellik adı, özellik türü ve sahip türü ile bir bağımlılık özelliği kaydeder.Registers a dependency property with the specified property name, property type, and owner type.

Register(String, Type, Type, PropertyMetadata)

Belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileri ile bir bağımlılık özelliği kaydeder.Registers a dependency property with the specified property name, property type, owner type, and property metadata.

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

Belirtilen özellik adı, özellik türü, sahip türü, özellik meta verileri ve özellik için bir değer doğrulama geri çağırması olan bir bağımlılık özelliğini kaydeder.Registers a dependency property with the specified property name, property type, owner type, property metadata, and a value validation callback for the property.

RegisterAttached(String, Type, Type)

Eklenmiş bir özelliği belirtilen özellik adı, özellik türü ve sahip türü ile kaydeder.Registers an attached property with the specified property name, property type, and owner type.

RegisterAttached(String, Type, Type, PropertyMetadata)

Belirtilen özellik adı, özellik türü, sahip türü ve özellik meta verileri ile birlikte iliştirilmiş bir özelliği kaydeder.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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

Özellik için belirtilen özellik türü, sahip türü, özellik meta verileri ve değer doğrulama geri çağırması ile iliştirilmiş bir özelliği kaydeder.Registers an attached property with the specified property type, owner type, property metadata, and value validation callback for the property.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Belirtilen özellik türü, sahip türü ve özellik meta verileri ile birlikte bir salt okunurdur ekli özelliği kaydeder.Registers a read-only attached property, with the specified property type, owner type, and property metadata.

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

Belirtilen özellik türü, sahip türü, özellik meta verileri ve bir doğrulama geri çağırması ile bir salt okunurdur ekli özelliği kaydeder.Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

Belirtilen özellik türü, sahip türü ve özellik meta verileri ile salt okunurdur bir bağımlılık özelliği kaydeder.Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

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 okunurdur bir bağımlılık özelliği kaydeder.Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString()

Dependency özelliğinin dize gösterimini döndürür.Returns the string representation of the dependency property.

Şunlara uygulanır

Ayrıca bkz.