DependencyProperty Třída

Definice

Představuje vlastnost, kterou lze nastavit prostřednictvím metod, jako jsou styling, datové vazby, animace a dědičnost.

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
Dědičnost
DependencyProperty
Atributy

Poznámky

DependencyProperty podporuje následující funkce ve Windows Presentation Foundation (WPF):

  • Vlastnost lze nastavit ve stylu. Další informace naleznete v tématu styling a šablonování.

  • Vlastnost lze nastavit prostřednictvím datové vazby. Další informace o vlastnostech závislostí datové vazby naleznete v tématu Postupy: Vytvoření vazby vlastností dvou ovládacích prvků.

  • Vlastnost lze nastavit pomocí odkazu na dynamický prostředek. Další informace najdete v tématu prostředky XAML.

  • Vlastnost může dědit jeho hodnotu automaticky z nadřazeného prvku ve stromu elementu. Další informace naleznete v tématu Dědičnost hodnoty vlastnosti.

  • Vlastnost může být animovaná. Další informace naleznete v tématu Přehled animací.

  • Vlastnost může hlásit, když byla změněna předchozí hodnota vlastnosti a hodnota vlastnosti může být vyřazena. Další informace naleznete v tématu zpětné volání vlastností závislostí a ověřování.

  • Vlastnost hlásí informace WPF, například zda změna hodnoty vlastnosti by měla vyžadovat, aby systém rozložení rekompose vizuály pro prvek.

  • Tato vlastnost obdrží podporu v návrháři WPF pro Visual Studio. Vlastnost lze například upravit v okně Vlastnosti.

Další informace o vlastnostech závislostí najdete v tématu Přehled vlastností závislostí. Pokud chcete, aby vlastnosti vlastních typů podporovaly možnosti v předchozím seznamu, měli byste vytvořit vlastnost závislosti. Informace o vytváření vlastních vlastností závislostí najdete v tématu vlastnosti vlastní závislosti.

Připojená vlastnost je vlastnost, která umožňuje libovolnému objektu hlásit informace typu, který definuje připojenou vlastnost. V WPF může jakýkoli typ, který dědí z DependencyObject použít připojenou vlastnost bez ohledu na to, zda typ dědí z typu, který definuje vlastnost. Připojená vlastnost je funkce jazyka XAML. Chcete-li nastavit připojenou vlastnost v XAML, použijte ownerType. syntaxepropertyName Příkladem připojené vlastnosti je DockPanel.Dock vlastnost. Pokud chcete vytvořit vlastnost, kterou lze použít pro všechny typy DependencyObject, měli byste vytvořit připojenou vlastnost. Další informace o připojených vlastnostech, včetně postupu jejich vytvoření, najdete v tématu Přehled připojených vlastností.

Použití atributu XAML

<object property="dependencyPropertyName"/>  

-nebo-

<object property="ownerType.dependencyPropertyName"/>  

-nebo-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Hodnoty XAML

dependencyPropertyName
Řetězec, který určuje DependencyProperty.Name požadované vlastnosti závislosti. Toto může předcházet předpona oboru názvů XML, pokud tato vlastnost není ve výchozím oboru názvů XML (podrobnosti najdete v tématu obory názvů XAML a mapování oboru názvů pro WPF XAML.)

ownerType.dependencyPropertyName
Řetězec, který určuje typ vlastníka vlastnosti závislosti, tečku (.), pak DependencyProperty.Name. ownerType může předcházet také předpona oboru názvů XML. Toto použití je specifické pro styly a šablony s pozdní vazbou, kde vlastník vlastnosti závislosti musí být zadán pro parsování kontextu, protože TargetType ještě není známo. Další informace naleznete v tématu styling a šablonování.

attachedPropertyOwnerType .attachedPropertyName
Řetězec, který určuje vlastníka připojené vlastnosti, tečku (.), pak název připojené vlastnosti. attachedPropertyOwnerType může předcházet také předpona oboru názvů XML.

Pole

UnsetValue

Určuje statickou hodnotu, kterou používá systém vlastností WPF místo null k označení, že vlastnost existuje, ale nemá její hodnotu nastavenou systémem vlastností.

Vlastnosti

DefaultMetadata

Získá výchozí metadata vlastnosti závislosti.

GlobalIndex

Získá interně vygenerovanou hodnotu, která jedinečně identifikuje vlastnost závislosti.

Name

Získá název vlastnosti závislosti.

OwnerType

Získá typ objektu, který zaregistroval vlastnost závislosti v systému vlastností, nebo sám jako vlastník vlastnosti.

PropertyType

Získá typ, který vlastnost závislosti používá pro jeho hodnotu.

ReadOnly

Získá hodnotu, která označuje, zda závislost vlastnost identifikovaná tímto DependencyProperty instance je závislost jen pro čtení vlastnost.

ValidateValueCallback

Získá zpětná volání ověření hodnoty pro vlastnost závislosti.

Metody

AddOwner(Type)

Přidá další typ jako vlastníka vlastnosti závislosti, která již byla zaregistrována.

AddOwner(Type, PropertyMetadata)

Přidá další typ jako vlastníka vlastnosti závislosti, která již byla zaregistrována a poskytuje metadata vlastností závislostí pro vlastnost závislosti, protože bude existovat u zadaného typu vlastníka.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Vrátí kód hash pro tento DependencyProperty.

GetMetadata(DependencyObject)

Vrátí metadata pro tuto vlastnost závislosti, protože existuje v zadané instanci objektu.

GetMetadata(DependencyObjectType)

Vrátí metadata pro tuto vlastnost závislosti, protože existuje v zadaném typu.

GetMetadata(Type)

Vrátí metadata pro tuto vlastnost závislosti, protože existuje u zadaného existujícího typu.

GetType()

Získá Type aktuální instance.

(Zděděno od Object)
IsValidType(Object)

Určuje, zda je zadaná hodnota pro typ této vlastnosti závislosti přijatelná, jak je zaškrtnuto proti typu vlastnosti zadané v původní registraci vlastnosti závislosti.

IsValidValue(Object)

Určuje, zda je zadaná hodnota přijata pro typ vlastnosti prostřednictvím základní kontroly typů, a také pokud je v povoleném rozsahu hodnot pro daný typ.

MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
OverrideMetadata(Type, PropertyMetadata)

Určuje alternativní metadata pro tuto vlastnost závislosti, pokud je přítomna na instancích zadaného typu, přepsání metadat, která existovala pro vlastnost závislosti, protože byla zděděna ze základních typů.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Poskytuje alternativní metadata pro vlastnost závislostí jen pro čtení, pokud je přítomna na instancích zadaného typu, přepsání metadat, která byla zadána v počáteční registraci vlastnosti závislosti. Je nutné předat DependencyPropertyKey pro vlastnost závislostí jen pro čtení, aby se zabránilo vyvolání výjimky.

Register(String, Type, Type)

Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.

Register(String, Type, Type, PropertyMetadata)

Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka a metadaty vlastností.

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

Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření hodnoty pro vlastnost.

RegisterAttached(String, Type, Type)

Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.

RegisterAttached(String, Type, Type, PropertyMetadata)

Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka a metadaty vlastností.

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

Zaregistruje připojenou vlastnost se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětném voláním ověření hodnoty pro vlastnost.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Zaregistruje připojenou vlastnost jen pro čtení se zadaným typem vlastnosti, typem vlastníka a metadaty vlastností.

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

Zaregistruje připojenou vlastnost jen pro čtení se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

Zaregistruje vlastnost závislostí jen pro čtení se zadaným typem vlastnosti, typem vlastníka a metadaty vlastností.

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

Zaregistruje vlastnost závislostí jen pro čtení se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření.

ToString()

Vrátí řetězcovou reprezentaci vlastnosti závislosti.

Platí pro

Viz také