DependencyProperty DependencyProperty DependencyProperty DependencyProperty Class

Definition

Stellt eine Eigenschaft dar, die durch Methoden festgelegt werden kann, z. B. Formatierung, Datenbindung, Animation und Vererbung.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
Vererbung
DependencyPropertyDependencyPropertyDependencyPropertyDependencyProperty
Attribute

Hinweise

Ein DependencyProperty unterstützt die folgenden Funktionen in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):A DependencyProperty supports the following capabilities in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF):

  • Die Eigenschaft kann in einem Stil festgelegt werden.The property can be set in a style. Weitere Informationen finden Sie unter Erstellen von Formaten und Vorlagen.For more information, see Styling and Templating.

  • Die Eigenschaft kann über die Datenbindung festgelegt werden.The property can be set through data binding. Weitere Informationen zur Datenbindung mit Abhängigkeitseigenschaften finden Sie unter Vorgehensweise: Binden der Eigenschaften von zwei Steuerelementen.For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • Die Eigenschaft kann mit einem dynamischen Ressourcenverweis festgelegt werden.The property can be set with a dynamic resource reference. Weitere Informationen finden Sie unter XAML-Ressourcen.For more information, see XAML Resources.

  • Die Eigenschaft kann den Wert automatisch von einem übergeordneten Element in der Elementstruktur erben.The property can inherit its value automatically from a parent element in the element tree. Weitere Informationen finden Sie unter Vererbung von Eigenschaftswerten.For more information, see Property Value Inheritance.

  • Die Eigenschaft kann animiert werden.The property can be animated. Weitere Informationen finden Sie unter Übersicht über Animation.For more information, see Animation Overview.

  • Die Eigenschaft kann melden, wenn der vorherige Wert der Eigenschaft geändert wurde und den Wert der Eigenschaft umgewandelt werden kann.The property can report when the previous value of the property has been changed and the property value can be coerced. Weitere Informationen finden Sie unter Rückrufe und Validierung von Abhängigkeitseigenschaften.For more information, see Dependency Property Callbacks and Validation.

  • Die Eigenschaft meldet Informationen zu WPFWPF, z. B., ob Ändern eines Eigenschaftswerts das Layoutsystem die visuellen Objekte für ein Element Zertifikatsinfrastruktur mehr erforderlich ist.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.

  • Die Eigenschaft empfängt-Unterstützung in den WPF-Designer für Visual StudioWPF Designer for Visual Studio.The property receives support in the WPF-Designer für Visual StudioWPF Designer for Visual Studio. Beispielsweise kann die Eigenschaft bearbeitet werden, der Eigenschaften Fenster.For example, the property can be edited in the Properties window.

Weitere Informationen zu Abhängigkeitseigenschaften finden Sie unter Übersicht über Abhängigkeitseigenschaften.To learn more about dependency properties, see Dependency Properties Overview. Wenn Sie Eigenschaften für die benutzerdefinierten Typen zur Unterstützung von Funktionen in der vorangehenden Liste wünschen, sollten Sie eine Abhängigkeitseigenschaft erstellen.If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. Vorgehensweise: Erstellen von benutzerdefinierten Abhängigkeitseigenschaften finden Sie unter benutzerdefinierte Abhängigkeitseigenschaften.To learn how to create custom dependency properties, see Custom Dependency Properties.

Eine angefügte Eigenschaft ist eine Eigenschaft, mit der jedes beliebige Objekt an den Informationen in den Typ, der die angefügte Eigenschaft definiert.An attached property is a property that enables any object to report information to the type that defines the attached property. In WPFWPF, jeder Typ, der von erbt DependencyObject können unabhängig davon, ob der Typ vom Typ erbt, die die Eigenschaft definiert eine angefügte Eigenschaft.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. Eine angefügte Eigenschaft ist ein Feature von der XAMLXAML Sprache.An attached property is a feature of the XAMLXAML language. Eine angefügte Eigenschaft festlegen, in XAMLXAML, verwenden Sie die Besitzertyp. PropertyName Syntax.To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. Ein Beispiel für eine angefügte Eigenschaft ist die DockPanel.Dock Eigenschaft.An example of an attached property is the DockPanel.Dock property. Wenn eine Eigenschaft zu erstellen, die auf allen verwendet werden können sollen DependencyObject eingibt, dann sollten Sie eine angefügte Eigenschaft erstellen.If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. Weitere Informationen zu angefügten Eigenschaften, einschließlich Informationen zum Erstellen, finden Sie unter Übersicht über angefügte Eigenschaften.To learn more about attached properties, including how to create them, see Attached Properties Overview.

Verwendung von XAML-AttributenXAML Attribute Usage

<object property="dependencyPropertyName"/>  
- or -  
<object property="ownerType.dependencyPropertyName"/>  
- or -  
<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML-WerteXAML Values

dependencyPropertyName
Eine Zeichenfolge, der angibt, die DependencyProperty.Name der gewünschten Abhängigkeitseigenschaft.A string that specifies the DependencyProperty.Name of the desired dependency property. Dies kann vorangestellt werden ein XML-Namespacepräfix, wenn die Eigenschaft nicht in der XML-Standardnamespace ist (Weitere Informationen finden Sie unter XAML-Namespaces und Namespace-Zuordnung für 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
Eine Zeichenfolge, die eines Besitzertyps für eine Abhängigkeitseigenschaft, der einen Punkt (.) gibt an, und klicken Sie dann die DependencyProperty.Name.A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType kann auch ein XML-Namespacepräfix vorangestellt werden.ownerType can also be preceded by an XML namespace prefix. Diese Verwendung ist speziell für spät gebundene-Stile und Vorlagen, der Besitzer der Abhängigkeitseigenschaft angegeben werden, muss für die Analyse von Kontext, da die TargetType ist noch nicht bekannt.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. Weitere Informationen finden Sie unter Erstellen von Formaten und Vorlagen.For more information, see Styling and Templating.

attachedPropertyOwnerType .attachedPropertyOwnerType . attachedPropertyName
Eine Zeichenfolge, die den Besitzer einer angefügten Eigenschaft, ein Punkt (.) und dann den Namen der angefügten Eigenschaft angibt.A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType kann auch ein XML-Namespacepräfix vorangestellt werden.attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

Felder

UnsetValue UnsetValue UnsetValue UnsetValue

Gibt einen statischen Wert an, der vom WPFWPF-Eigenschaftensystem verwendet wird, und nicht null, um anzugeben, dass die Eigenschaft vorhanden ist, der Wert jedoch nicht vom Eigenschaftensystem festgelegt wird.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.

Eigenschaften

DefaultMetadata DefaultMetadata DefaultMetadata DefaultMetadata

Ruft die Standardmetadaten der Abhängigkeitseigenschaft ab.Gets the default metadata of the dependency property.

GlobalIndex GlobalIndex GlobalIndex GlobalIndex

Ruft einen intern generierten Wert ab, der die Abhängigkeitseigenschaft eindeutig identifiziert.Gets an internally generated value that uniquely identifies the dependency property.

Name Name Name Name

Ruft den Namen der Abhängigkeitseigenschaft ab.Gets the name of the dependency property.

OwnerType OwnerType OwnerType OwnerType

Ruft den Typ des Objekts ab, das die Abhängigkeitseigenschaft im Eigenschaftensystem registriert oder sich selbst als Besitzer der Eigenschaft hinzugefügt hat.Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType PropertyType PropertyType PropertyType

Ruft den Typ ab, den die Abhängigkeitseigenschaft für den Wert verwendet.Gets the type that the dependency property uses for its value.

ReadOnly ReadOnly ReadOnly ReadOnly

Ruft einen Wert ab, der angibt, ob die von dieser DependencyProperty-Instanz angegebene Abhängigkeitseigenschaft eine schreibgeschützte Abhängigkeitseigenschaft ist.Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback ValidateValueCallback ValidateValueCallback ValidateValueCallback

Ruft den Wertvalidierungsrückruf für die Abhängigkeitseigenschaft ab.Gets the value validation callback for the dependency property.

Methoden

AddOwner(Type) AddOwner(Type) AddOwner(Type) AddOwner(Type)

Fügt einen weiteren Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits registriert wurde.Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata)

Fügt einen anderen Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits registriert wurde. Dabei werden Abhängigkeitseigenschaft-Metadaten für die Abhängigkeitseigenschaft bereitgestellt, wie sie für den bereitgestellten Besitzertyp vorhanden sind.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) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt einen Hashcode für diese DependencyProperty zurück.Returns a hash code for this DependencyProperty.

GetMetadata(DependencyObject) GetMetadata(DependencyObject) GetMetadata(DependencyObject) GetMetadata(DependencyObject)

Gibt die Metadaten für diese Abhängigkeitseigenschaft zurück, da sie für die angegebene Objektinstanz vorhanden sind.Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType) GetMetadata(DependencyObjectType) GetMetadata(DependencyObjectType) GetMetadata(DependencyObjectType)

Gibt die Metadaten für diese Abhängigkeitseigenschaft zurück, wie sie für einen angegebenen Typ vorhanden sind.Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type) GetMetadata(Type) GetMetadata(Type) GetMetadata(Type)

Gibt die Metadaten für diese Abhängigkeitseigenschaft zurück, wie sie für einen angegebenen vorhanden Typ vorhanden sind.Returns the metadata for this dependency property as it exists on a specified existing type.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsValidType(Object) IsValidType(Object) IsValidType(Object) IsValidType(Object)

Bestimmt, ob ein angegebener Wert für den Typ dieser Abhängigkeitseigenschaft akzeptiert wird, wie anhand des in der Registrierung der ursprünglichen Abhängigkeitseigenschaft angegebenen Eigenschaftentyps überprüft wurde.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) IsValidValue(Object) IsValidValue(Object) IsValidValue(Object)

Bestimmt, ob der angegebene Wert für den Eigenschaftentyp durch eine einfache Typüberprüfung zulässig ist und ob er sich potenziell im zulässigen Wertebereich für den Typ befindet.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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata)

Gibt alternative Metadaten für diese Abhängigkeitseigenschaft an, wenn sie in Instanzen eines angegebenen Typs vorhanden ist. Dabei werden die Metadaten überschrieben, die für die Abhängigkeitseigenschaft bei der Vererbung von Basistypen vorhanden waren.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) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Stellt alternative Metadaten für eine schreibgeschützte Abhängigkeitseigenschaft bereit, wenn sie in Instanzen eines angegebenen Typs vorhanden ist, wodurch die Metadaten überschrieben werden, die bei der ersten Registrierung der Abhängigkeitseigenschaft bereitgestellt wurden.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. Sie müssen die DependencyPropertyKey für die schreibgeschützte Abhängigkeitseigenschaft übergeben, um das Auslösen einer Ausnahme zu vermeiden.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

Register(String, Type, Type) Register(String, Type, Type) Register(String, Type, Type) Register(String, Type, Type)

Registriert eine Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp.Registers a dependency property with the specified property name, property type, and owner type.

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

Registriert eine Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp sowie den angegebenen Eigenschaftsmetadaten.Registers a dependency property with the specified property name, property type, owner type, and property metadata.

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

Registriert eine Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp, Besitzertyp, den angegebenen Eigenschaftsmetadaten und einem angegebenen Wertvalidierungsrückruf für die Eigenschaft.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) RegisterAttached(String, Type, Type) RegisterAttached(String, Type, Type) RegisterAttached(String, Type, Type)

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp.Registers an attached property with the specified property name, property type, and owner type.

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

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftsnamen, Eigenschaftstyp und Besitzertyp sowie den angegebenen Eigenschaftenmetadaten.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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

Registriert eine angefügte Eigenschaft mit dem angegebenen Eigenschaftstyp, Besitzertyp, den angegebenen Eigenschaftsmetadaten und dem angegebenen Wertvalidierungsrückruf für die Eigenschaft.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) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata) RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Registriert eine schreibgeschützte angefügte Eigenschaft mit dem angegebenen Eigenschaftstyp und Besitzertyp sowie den angegebenen Eigenschaftsmetadaten.Registers a read-only attached property, with the specified property type, owner type, and property metadata.

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

Registriert eine schreibgeschützte Eigenschaft mit dem angegebenen Eigenschaftstyp, Besitzertyp, den angegebenen Eigenschaftsmetadaten und einem Validierungsrückruf.Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

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

Registriert eine schreibgeschützte Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftstyp und Besitzertyp sowie den angegebenen Eigenschaftsmetadaten.Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

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

Registriert eine schreibgeschützte Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftstyp, Besitzertyp, den angegebenen Eigenschaftsmetadaten und einem Validierungsrückruf.Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString() ToString() ToString() ToString()

Gibt die Zeichenfolgendarstellung der Abhängigkeitseigenschaft zurück.Returns the string representation of the dependency property.

Gilt für:

Siehe auch