DependencyProperty Klasa

Definicja

Reprezentuje właściwość, którą można ustawić za pomocą metod, takich jak style, powiązanie danych, animacja i dziedziczenie.Represents a property that can be set through methods such as, styling, data binding, animation, and inheritance.

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

Uwagi

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

  • Właściwość można ustawić w stylu.The property can be set in a style. Aby uzyskać więcej informacji, zobacz Style i tworzenia szablonów.For more information, see Styling and Templating.

  • Właściwość można ustawić za pomocą powiązania danych.The property can be set through data binding. Aby uzyskać więcej informacji na temat właściwości zależności powiązań danych, zobacz How to: bind właściwości dwóch kontrolek.For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • Właściwość można ustawić z odwołaniem do zasobu dynamicznego.The property can be set with a dynamic resource reference. Aby uzyskać więcej informacji, zobacz zasoby XAML.For more information, see XAML Resources.

  • Właściwość może dziedziczyć swoją wartość automatycznie z elementu nadrzędnego w drzewie elementów.The property can inherit its value automatically from a parent element in the element tree. Aby uzyskać więcej informacji, zobacz dziedziczenie wartości właściwości.For more information, see Property Value Inheritance.

  • Właściwość można animować.The property can be animated. Aby uzyskać więcej informacji, zobacz Omówienie animacji.For more information, see Animation Overview.

  • Właściwość może raportować, kiedy została zmieniona Poprzednia wartość właściwości, a wartość właściwości może być wymuszona.The property can report when the previous value of the property has been changed and the property value can be coerced. Aby uzyskać więcej informacji, zobacz wywołania zwrotne właściwości zależności i walidacja.For more information, see Dependency Property Callbacks and Validation.

  • Właściwość raportuje informacje do WPFWPF, na przykład czy zmiana wartości właściwości powinna wymagać od systemu układu przetworzenia wizualizacji dla elementu.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.

  • Właściwość otrzymuje obsługę w WPF Designer for Visual StudioWPF Designer for Visual Studio.The property receives support in the WPF Designer for Visual StudioWPF Designer for Visual Studio. Na przykład właściwość można edytować w oknie Właściwości .For example, the property can be edited in the Properties window.

Aby dowiedzieć się więcej o właściwościach zależności, zobacz Omówienie właściwości zależności.To learn more about dependency properties, see Dependency Properties Overview. Jeśli chcesz, aby właściwości typów niestandardowych obsługiwały możliwości z powyższej listy, należy utworzyć właściwość zależności.If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. Aby dowiedzieć się, jak utworzyć niestandardowe właściwości zależności, zobacz niestandardowe właściwości zależności.To learn how to create custom dependency properties, see Custom Dependency Properties.

Dołączona właściwość jest właściwością, która umożliwia każdemu obiektowi zgłaszanie informacji do typu, który definiuje załączoną właściwość.An attached property is a property that enables any object to report information to the type that defines the attached property. W WPFWPFkażdy typ, który dziedziczy po DependencyObject, może używać dołączonej właściwości niezależnie od tego, czy typ dziedziczy z typu, który definiuje właściwość.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. Dołączona właściwość jest funkcją języka XAMLXAML.An attached property is a feature of the XAMLXAML language. Aby ustawić dołączoną właściwość w XAMLXAML, użyj elementu OwnerType. Składnia PropertyName .To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. Przykładem dołączonej właściwości jest właściwość DockPanel.Dock.An example of an attached property is the DockPanel.Dock property. Jeśli chcesz utworzyć właściwość, która może być używana dla wszystkich typów DependencyObject, należy utworzyć dołączoną właściwość.If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. Aby dowiedzieć się więcej o dołączanych właściwościach, w tym o sposobie ich tworzenia, zobacz Omówienie dołączanych właściwości.To learn more about attached properties, including how to create them, see Attached Properties Overview.

Użycie atrybutu języka XAMLXAML Attribute Usage

<object property="dependencyPropertyName"/>  

—lub—-or-

<object property="ownerType.dependencyPropertyName"/>  

—lub—-or-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Wartości XAMLXAML Values

dependencyPropertyName
Ciąg określający DependencyProperty.Name żądanej właściwości zależności.A string that specifies the DependencyProperty.Name of the desired dependency property. 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 sekcję przestrzenie nazw XAML i mapowanie przestrzeni nazw dla WPF XAML).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
Ciąg określający typ właściciela właściwości zależności, kropki (.), a następnie DependencyProperty.Name.A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType może być również poprzedzony prefiksem przestrzeni nazw XML.ownerType can also be preceded by an XML namespace prefix. To użycie jest szczególnie powiązane ze stylami i szablonami, w których należy określić właściciela właściwości zależności dla kontekstu analizy, ponieważ TargetType nie jest jeszcze znana.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. Aby uzyskać więcej informacji, zobacz Style i tworzenia szablonów.For more information, see Styling and Templating.

attachedPropertyOwnerType .attachedPropertyOwnerType . attachedPropertyName
Ciąg określający właściciela dołączonej właściwości, kropkę (.), a następnie nazwę dołączonej właściwości.A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType może być również poprzedzony prefiksem przestrzeni nazw XML.attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

Pola

UnsetValue

Określa wartość statyczną używaną przez system właściwości WPFWPF, a nie null do wskazania, że właściwość istnieje, ale nie ma ustawionej wartości przez system właściwości.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.

Właściwości

DefaultMetadata

Pobiera domyślne metadane właściwości zależności.Gets the default metadata of the dependency property.

GlobalIndex

Pobiera wewnętrznie wygenerowaną wartość, która jednoznacznie identyfikuje właściwość zależności.Gets an internally generated value that uniquely identifies the dependency property.

Name

Pobiera nazwę właściwości zależności.Gets the name of the dependency property.

OwnerType

Pobiera typ obiektu, który zarejestrował właściwość zależności z systemem właściwości lub został dodany jako właściciel właściwości.Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType

Pobiera typ, którego właściwość zależności używa dla jej wartości.Gets the type that the dependency property uses for its value.

ReadOnly

Pobiera wartość wskazującą, czy właściwość zależności identyfikowana przez to wystąpienie DependencyProperty jest właściwością zależności tylko do odczytu.Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback

Pobiera wywołanie zwrotne walidacji wartości dla właściwości zależności.Gets the value validation callback for the dependency property.

Metody

AddOwner(Type)

Dodaje inny typ jako właściciela właściwości zależności, która została już zarejestrowana.Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata)

Dodaje inny typ jako właściciela właściwości zależności, która została już zarejestrowana, dostarczając metadane właściwości zależności dla właściwości zależności, która będzie znajdować się w podanym typie właściciela.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)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Zwraca kod skrótu dla tego DependencyProperty.Returns a hash code for this DependencyProperty.

GetMetadata(DependencyObject)

Zwraca metadane dla tej właściwości zależności, która istnieje w określonym wystąpieniu obiektu.Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType)

Zwraca metadane dla tej właściwości zależności, która istnieje w określonym typie.Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type)

Zwraca metadane dla tej właściwości zależności, która istnieje w określonym istniejącym typie.Returns the metadata for this dependency property as it exists on a specified existing type.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
IsValidType(Object)

Określa, czy określona wartość jest akceptowalna dla tego typu właściwości zależności, sprawdzana względem typu właściwości podanego w oryginalnej rejestracji właściwości zależności.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)

Określa, czy podana wartość jest akceptowana dla typu właściwości za pomocą podstawowego sprawdzania typów, a także może być w dozwolonym zakresie wartości dla tego typu.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()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OverrideMetadata(Type, PropertyMetadata)

Określa alternatywne metadane dla tej właściwości zależności, gdy jest ona obecna w wystąpieniach określonego typu, zastępując metadane, które istniały dla właściwości zależności, ponieważ zostały odziedziczone z typów podstawowych.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)

Dostarcza alternatywne metadane dla właściwości zależności tylko do odczytu, gdy jest ona obecna w wystąpieniach określonego typu, zastępując metadane dostarczone w początkowej rejestracji właściwości zależności.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. Należy przekazać DependencyPropertyKey właściwości zależności tylko do odczytu, aby uniknąć ponoszenia wyjątku.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

Register(String, Type, Type)

Rejestruje właściwość zależności z określoną nazwą właściwości, typem właściwości i typem właściciela.Registers a dependency property with the specified property name, property type, and owner type.

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.Registers a dependency property with the specified property name, property type, owner type, and property metadata.

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 walidacji wartości właściwości.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)

Rejestruje załączoną właściwość o określonej nazwie właściwości, typie właściwości i typie właściciela.Registers an attached property with the specified property name, property type, and owner type.

RegisterAttached(String, Type, Type, PropertyMetadata)

Rejestruje dołączoną właściwość o określonej nazwie właściwości, typie właściwości, typie właściciela i metadanych właściwości.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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

Rejestruje załączoną właściwość o określonym typie właściwości, typie właściciela, metadanych właściwości i wywołaniu zwrotnym walidacji wartości właściwości.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)

Rejestruje dołączoną właściwość tylko do odczytu, z określonym typem właściwości, typem właściciela i metadanymi właściwości.Registers a read-only attached property, with the specified property type, owner type, and property metadata.

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

Rejestruje przyłączoną właściwość tylko do odczytu, z określonym typem właściwości, typem właściciela, metadanymi właściwości i wywołaniem zwrotnym walidacji.Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

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.Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

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 walidacji.Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString()

Zwraca ciąg reprezentujący właściwość zależności.Returns the string representation of the dependency property.

Dotyczy

Zobacz też