DependencyProperty Klasa

Definicja

Reprezentuje właściwość, którą można ustawić za pomocą metod, takich jak stylizacja, powiązanie danych, animacja i dziedziczenie.

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
Dziedziczenie
DependencyProperty
Atrybuty

Uwagi

A DependencyProperty obsługuje następujące możliwości w Windows Presentation Foundation (WPF):

Aby dowiedzieć się więcej o właściwościach zależności, zobacz Właściwości zależności — omówienie. Jeśli chcesz, aby właściwości w typach niestandardowych obsługiwały możliwości na powyższej liście, należy utworzyć właściwość zależności. Aby dowiedzieć się, jak tworzyć niestandardowe właściwości zależności, zobacz Właściwości zależności niestandardowych.

Dołączona właściwość jest właściwością, która umożliwia dowolnemu obiektowi zgłaszanie informacji do typu definiującego dołączoną właściwość. W WPF każdy typ dziedziczony z DependencyObject może używać dołączonej właściwości niezależnie od tego, czy typ dziedziczy po typie definiującym właściwość. Dołączona właściwość jest funkcją języka XAML. Aby ustawić dołączoną właściwość w języku XAML, użyj właściwości ownerType. propertyName składnia. Przykładem dołączonej właściwości jest DockPanel.Dock właściwość . Jeśli chcesz utworzyć właściwość, która może być używana we wszystkich DependencyObject typach, należy utworzyć dołączoną właściwość. Aby dowiedzieć się więcej o dołączonych właściwościach, w tym o sposobie ich tworzenia, zobacz Omówienie dołączonych właściwości.

Użycie atrybutu języka XAML

<object property="dependencyPropertyName"/>  

-lub-

<object property="ownerType.dependencyPropertyName"/>  

-lub-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Wartości XAML

dependencyPropertyName
Ciąg określający DependencyProperty.Name żądaną właściwość zależności. Może to być poprzedzone prefiksem przestrzeni nazw XML, jeśli właściwość nie znajduje się w domyślnej przestrzeni nazw XML (aby uzyskać szczegółowe informacje, zobacz Przestrzenie nazw XAML XAML i Mapowanie przestrzeni nazw dla WPF XAML).

ownerType.dependencyPropertyName
Ciąg określający typ właściciela właściwości zależności, kropkę (.), a następnie DependencyProperty.Name. ownerType może być również poprzedzony prefiksem przestrzeni nazw XML. To użycie jest szczególnie związane ze stylami i szablonami, w których właściciel właściwości zależności musi być określony do analizowania kontekstu, ponieważ TargetType nie jest jeszcze znany. Aby uzyskać więcej informacji, zobacz Styling and Templating (Tworzenie stylów i tworzenie szablonów).

attachedPropertyOwnerType . attachedPropertyName
Ciąg określający właściciela dołączonej właściwości, kropkę (.), a następnie dołączoną nazwę właściwości. attachedPropertyOwnerType może być również poprzedzony prefiksem przestrzeni nazw XML.

Pola

UnsetValue

Określa wartość statyczną używaną przez system właściwości WPF zamiast null wskazywać, że właściwość istnieje, ale nie ma jej wartości ustawionej przez system właściwości.

Właściwości

DefaultMetadata

Pobiera domyślne metadane właściwości zależności.

GlobalIndex

Pobiera wewnętrznie wygenerowaną wartość, która jednoznacznie identyfikuje właściwość zależności.

Name

Pobiera nazwę właściwości zależności.

OwnerType

Pobiera typ obiektu, który zarejestrował właściwość zależności z systemem właściwości lub dodał się jako właściciel właściwości.

PropertyType

Pobiera typ używany przez właściwość zależności dla jej wartości.

ReadOnly

Pobiera wartość wskazującą, czy właściwość zależności zidentyfikowana przez to DependencyProperty wystąpienie jest właściwością zależności tylko do odczytu.

ValidateValueCallback

Pobiera wywołanie zwrotne weryfikacji wartości dla właściwości zależności.

Metody

AddOwner(Type)

Dodaje inny typ jako właściciel właściwości zależności, która została już zarejestrowana.

AddOwner(Type, PropertyMetadata)

Dodaje inny typ jako właściciel właściwości zależności, która została już zarejestrowana, zapewniając metadane właściwości zależności dla właściwości zależności, ponieważ będzie istnieć w podanym typie właściciela.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Zwraca kod skrótu dla tego DependencyProperty.

GetMetadata(DependencyObject)

Zwraca metadane dla tej właściwości zależności, ponieważ istnieje w określonym wystąpieniu obiektu.

GetMetadata(DependencyObjectType)

Zwraca metadane dla tej właściwości zależności, ponieważ istnieje w określonym typie.

GetMetadata(Type)

Zwraca metadane dla tej właściwości zależności, ponieważ istnieje w określonym istniejącym typie.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
IsValidType(Object)

Określa, czy określona wartość jest akceptowalna dla typu tej właściwości zależności, zgodnie z typem właściwości podanym w pierwotnej rejestracji właściwości zależności.

IsValidValue(Object)

Określa, czy podana wartość jest akceptowana dla typu właściwości za pomocą podstawowego sprawdzania typów, a także potencjalnie, jeśli znajduje się ona w dozwolonym zakresie wartości dla tego typu.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OverrideMetadata(Type, PropertyMetadata)

Określa alternatywne metadane dla tej właściwości zależności, gdy są obecne w wystąpieniach określonego typu, przesłaniając metadane, które istniały dla właściwości zależności, ponieważ były dziedziczone z typów bazowych.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Dostarcza alternatywne metadane dla właściwości zależności tylko do odczytu, gdy jest obecny w wystąpieniach określonego typu, przesłaniając metadane podane w początkowej rejestracji właściwości zależności. Aby uniknąć zgłaszania wyjątku, należy przekazać DependencyPropertyKey właściwość zależności tylko do odczytu.

Register(String, Type, Type)

Rejestruje właściwość zależności o określonej nazwie właściwości, typie właściwości i typie właściciela.

Register(String, Type, Type, PropertyMetadata)

Rejestruje właściwość zależności z określoną nazwą właściwości, typem właściwości, typem właściciela i metadanymi właściwości.

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

Rejestruje właściwość zależności z określoną nazwą właściwości, typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym weryfikacji wartości dla właściwości.

RegisterAttached(String, Type, Type)

Rejestruje dołączoną właściwość o określonej nazwie właściwości, typie właściwości i typie właściciela.

RegisterAttached(String, Type, Type, PropertyMetadata)

Rejestruje dołączoną właściwość z określoną nazwą właściwości, typem właściwości, typem właściciela i metadanymi właściwości.

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

Rejestruje dołączoną właściwość z określonym typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym weryfikacji wartości dla właściwości.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Rejestruje właściwość dołączoną tylko do odczytu z określonym typem właściwości, typem właściciela i metadanymi właściwości.

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

Rejestruje właściwość dołączoną tylko do odczytu z określonym typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym weryfikacji.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

Rejestruje właściwość zależności tylko do odczytu z określonym typem właściwości, typem właściciela i metadanymi właściwości.

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

Rejestruje właściwość zależności tylko do odczytu z określonym typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym weryfikacji.

ToString()

Zwraca reprezentację ciągu właściwości zależności.

Dotyczy

Zobacz też