DependencyProperty Osztály

Definíció

Névtér:

System.Windows

Szerelvény:

WindowsBase.dll

Olyan tulajdonságot jelöl, amely olyan módszerekkel állítható be, mint például a stílus, az adatkötés, az animáció és az öröklés.

public ref class DependencyProperty sealed

[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=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class

Public NotInheritable Class DependencyProperty

Öröklődés

Object

DependencyProperty

Attribútumok

TypeConverterAttribute

Megjegyzések

A DependencyProperty a következő képességeket támogatja Windows megjelenítési alaprendszer (WPF):

• A tulajdonság stílusban állítható be. További információ: Stílus és sablonkészítés.

• A tulajdonság adatkötéssel állítható be. További információ az adatkötés függőségi tulajdonságairól: Útmutató: Két vezérlő tulajdonságainak kötése.

• A tulajdonság dinamikus erőforrás-hivatkozással állítható be. További információ: XAML-erőforrások.

• A tulajdonság automatikusan örökölheti az értékét az elemfa szülőelemétől. További információ: Tulajdonságérték öröklése.

• A tulajdonság animálható. További információ: Animáció áttekintése.

• A tulajdonság jelentheti, ha a tulajdonság előző értéke módosult, és a tulajdonság értéke kényszeríthető. További információ: Dependency Property Callbacks and Validation.

• A tulajdonság információkat jelent WPF, például azt, hogy egy tulajdonság értékének módosításához az elrendezési rendszernek újra kell-e írnia egy elem vizualizációit.

• A tulajdonság támogatást kap a WPF Tervező Visual Studio. A tulajdonság például szerkeszthető a Tulajdonságok ablakban.

A függőségi tulajdonságokról további információt a Függőség tulajdonságainak áttekintése című témakörben talál. Ha azt szeretné, hogy az egyéni típusok tulajdonságai támogassák az előző listában szereplő képességeket, létre kell hoznia egy függőségi tulajdonságot. Az egyéni függőségi tulajdonságok létrehozásáról az Egyéni függőség tulajdonságai című témakörben olvashat.

A csatolt tulajdonság olyan tulajdonság, amely lehetővé teszi, hogy bármely objektum a csatolt tulajdonságot meghatározó típusnak jelentse az adatokat. Az WPF a DependencyObject-től öröklő bármely típus használhat csatolt tulajdonságot, függetlenül attól, hogy a típus örökli-e a tulajdonságot meghatározó típust. A csatolt tulajdonság az XAML nyelv egyik funkciója. Ha egy csatolt tulajdonságot szeretne beállítani az XAML-ben, használja a ownerType tulajdonságot. propertyName szintaxis. Egy csatolt tulajdonságra példa a DockPanel.Dock tulajdonság. Ha olyan tulajdonságot szeretne létrehozni, amely minden DependencyObject típushoz használható, akkor létre kell hoznia egy csatolt tulajdonságot. A csatolt tulajdonságokról, többek között a létrehozásuk módjáról további információt a Csatolt tulajdonságok áttekintése című témakörben talál.

XAML-attribútumok használata

<object property="dependencyPropertyName"/>

-vagy-

<object property="ownerType.dependencyPropertyName"/>

-vagy-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>

XAML-értékek

dependencyPropertyName A kívánt függőségi tulajdonságot meghatározó DependencyProperty.Name sztring. Ezt megelőzheti egy XML-névtér-előtag, ha a tulajdonság nem az alapértelmezett XML-névtérben található (részletekért lásd: XAML-névterek és WPF XAML névtérleképezése.)

ownerType. dependencyPropertyName Egy függőségi tulajdonság tulajdonostípusát meghatározó sztring, egy pont (.), majd a DependencyProperty.Name. ownerType AZ XML-névtér előtagja is megelőzhető. Ez a használat különösen a késői kötött stílusokra és sablonokra vonatkozik, ahol a függőségi tulajdonság tulajdonosát meg kell adni az elemzési környezethez, mert az TargetType még nem ismert. További információ: Stílus és sablonkészítés.

attachedPropertyOwnerType .attachedPropertyName Egy sztring, amely meghatározza a csatolt tulajdonság tulajdonosát, egy pont (.), majd a csatolt tulajdonság nevét. attachedPropertyOwnerType AZ XML-névtér előtagja is megelőzhető.

Mezők

Name	Description
UnsetValue	Olyan statikus értéket ad meg, amelyet a WPF tulajdonságrendszer használ a null helyett annak jelzésére, hogy a tulajdonság létezik, de nem rendelkezik a tulajdonságrendszer által beállított értékkel.

Tulajdonságok

Name	Description
DefaultMetadata	Lekéri a függőségi tulajdonság alapértelmezett metaadatait.
GlobalIndex	Egy belsőleg létrehozott értéket kap, amely egyedileg azonosítja a függőségi tulajdonságot.
Name	Lekéri a függőségi tulajdonság nevét.
OwnerType	Lekéri annak az objektumnak a típusát, amely regisztrálta a függőségi tulajdonságot a tulajdonságrendszerben, vagy hozzáadta magát a tulajdonság tulajdonosaként.
PropertyType	Lekéri azt a típust, amelyet a függőségi tulajdonság az értékéhez használ.
ReadOnly	Olyan értéket kap, amely jelzi, hogy a példány által DependencyProperty azonosított függőségi tulajdonság írásvédett függőségi tulajdonság-e.
ValidateValueCallback	Lekéri a függőség tulajdonság értékérvényesítési visszahívását.

Metódusok

Name	Description
AddOwner(Type, PropertyMetadata)	Hozzáad egy másik típust egy már regisztrált függőségi tulajdonság tulajdonosaként, és megadja a függőségi tulajdonság metaadatait, mivel az a megadott tulajdonostípuson fog létezni.
AddOwner(Type)	Egy másik típust ad hozzá egy már regisztrált függőségi tulajdonság tulajdonosaként.
GetHashCode()	Ehhez a függvényhez egy kivonatkódot ad DependencyPropertyvissza.
GetMetadata(DependencyObject)	A megadott objektumpéldányon létező függőségi tulajdonság metaadatait adja vissza.
GetMetadata(DependencyObjectType)	A függőségi tulajdonság metaadatait adja vissza, mivel egy adott típuson létezik.
GetMetadata(Type)	A függőségi tulajdonság metaadatait adja vissza, mivel egy megadott meglévő típuson létezik.
IsValidType(Object)	Meghatározza, hogy egy megadott érték elfogadható-e a függőségi tulajdonság típusához, az eredeti függőségi tulajdonságregisztrációban megadott tulajdonságtípussal összevetve.
IsValidValue(Object)	Meghatározza, hogy a megadott érték elfogadható-e a tulajdonság típusához alapszintű típusellenőrzéssel, és azt is, hogy az adott típus megengedett értéktartományán belül van-e.
OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)	Alternatív metaadatokat biztosít egy írásvédett függőségi tulajdonsághoz, ha egy adott típusú példányon jelen van, felülírva a kezdeti függőségi tulajdonságregisztrációban megadott metaadatokat. A kivétel elkerülése érdekében át kell adnia az DependencyPropertyKey írásvédett függőség tulajdonság értékét.
OverrideMetadata(Type, PropertyMetadata)	Alternatív metaadatokat ad meg ehhez a függőségi tulajdonsághoz, ha egy adott típusú példányon van jelen, felülírva a függőségi tulajdonság metaadatait, mivel az alaptípusoktól öröklődött.
Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Egy függőségi tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal, tulajdonostípussal, tulajdonság metaadataival és a tulajdonság értékérvényesítési visszahívásával.
Register(String, Type, Type, PropertyMetadata)	Egy függőségi tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal, tulajdonostípussal és tulajdonság metaadataival.
Register(String, Type, Type)	Egy függőségi tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal és tulajdonostípussal.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Regisztrál egy csatolt tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal, tulajdonság metaadataival és értékérvényesítési visszahívásával a tulajdonsághoz.
RegisterAttached(String, Type, Type, PropertyMetadata)	Egy csatolt tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal, tulajdonostípussal és tulajdonság metaadataival.
RegisterAttached(String, Type, Type)	Egy csatolt tulajdonságot regisztrál a megadott tulajdonságnévvel, tulajdonságtípussal és tulajdonostípussal.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Regisztrál egy írásvédett csatolt tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal, tulajdonság metaadatokkal és érvényesítési visszahívással.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)	Regisztrál egy írásvédett csatolt tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal és tulajdonság metaadataival.
RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Regisztrál egy írásvédett függőségi tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal, tulajdonság metaadataival és érvényesítési visszahívásával.
RegisterReadOnly(String, Type, Type, PropertyMetadata)	Regisztrál egy írásvédett függőségi tulajdonságot a megadott tulajdonságtípussal, tulajdonostípussal és tulajdonság metaadataival.
ToString()	A függőségi tulajdonság sztring-ábrázolását adja vissza.

Lásd még

• DependencyObject
• DependencyPropertyHelper