DependencyProperty DependencyProperty DependencyProperty DependencyProperty Class

Definition

Warnung

Diese API ist jetzt veraltet.

Eine besondere Eigenschaft, die definiert oder einem DependencyObject angefügt werden kann.A special kind of property that can be defined or attached to a DependencyObject. Man unterscheidet drei Arten von Abhängigkeitseigenschaften: Instanzeigenschaften, Meta-Eigenschaften und angefügte Eigenschaften.There are three kinds of dependency properties: instance properties, meta properties, and attached properties. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class DependencyProperty sealed : System::Runtime::Serialization::ISerializable
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
[System.Serializable]
public sealed class DependencyProperty : System.Runtime.Serialization.ISerializable
type DependencyProperty = class
    interface ISerializable
Public NotInheritable Class DependencyProperty
Implements ISerializable
Vererbung
DependencyPropertyDependencyPropertyDependencyPropertyDependencyProperty
Attribute
Implementiert

Beispiele

Das folgende Beispiel zeigt, wie DependencyProperty für die Verwendung durch DependencyObject registriert wird.The following example shows how to register a DependencyProperty for use by a DependencyObject. Dieses Codebeispiel ist Teil des Send E-Mail SDK-Beispiels und stammt aus der Datei SendMailActivity.cs.This code example is part of the Send Email SDK sample and is from the SendMailActivity.cs file. Weitere Informationen finden Sie unter Senden von e-Mail-Aktivität.For more information, see Send Mail Activity.

// Define the DependencyProperty objects for all of the Properties 
// ...and Events exposed by this activity
public static DependencyProperty FromProperty = DependencyProperty.Register("From", typeof(string), typeof(SendEmailActivity), new PropertyMetadata("someone@example.com"));
public static DependencyProperty ToProperty = DependencyProperty.Register("To", typeof(string), typeof(SendEmailActivity), new PropertyMetadata("someone@example.com"));
' Define the DependencyProperty objects for all of the Properties 
' ...and Events exposed by me activity
Public Shared FromEmailProperty As DependencyProperty = DependencyProperty.Register("From", GetType(String), GetType(SendEmailActivity), New PropertyMetadata("someone@example.com"))
Public Shared ToProperty As DependencyProperty = DependencyProperty.Register("To", GetType(String), GetType(SendEmailActivity), New PropertyMetadata("someone@example.com"))

Hinweise

Hinweis

In diesem Material werden veraltete Typen und Namespaces erläutert.This material discusses types and namespaces that are obsolete. Weitere Informationen finden Sie unter Veraltete Typen in Windows Workflow Foundation 4.5.For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

Abhängigkeitseigenschaften unterstützen drei Anwendungsfälle.Dependency properties support three use cases. Erster Fall: Wird eine Instanzeigenschaft mit einer Abhängigkeitseigenschaft implementiert, kann dieser Eigenschaft anstelle eines tatsächlichen Werts ActivityBind zugewiesen werden.First, if an instance property of an activity is implemented by using a dependency property, that property can be assigned an ActivityBind instead of an actual value. Zweiter Fall: Aktivitätseigenschaften, bei denen es sich um Metadaten handelt (d. h., der Wert kann während der Laufzeit nicht geändert werden) , sollten mithilfe von Abhängigkeitseigenschaften implementiert werden, wobei die Metadata-Option anzugeben ist.Second, activity properties that are metadata (that is, the value cannot change at run time) should be implemented by using dependency properties, specifying the Metadata option. Dritter Fall: Abhängigkeitseigenschaften unterstützen angefügte Eigenschaften. Dies sind Eigenschaften, die dynamisch für Abhängigkeitsobjekte übernommen werden.Third, dependency properties support attached properties, which are properties that are applied to dependency objects dynamically.

Eigenschaften

DefaultMetadata DefaultMetadata DefaultMetadata DefaultMetadata

Ruft den PropertyMetadata ab, der benutzerdefinierte Daten für DependencyProperty darstellt.Gets the PropertyMetadata that represents user-defined data for this DependencyProperty.

IsAttached IsAttached IsAttached IsAttached

Ruft die Eigenschaft ab, die angibt, ob DependencyProperty per Registrierung DependencyObject zugeordnet ist.Gets the property that indicates whether this DependencyProperty is associated to a DependencyObject by registration.

IsEvent IsEvent IsEvent IsEvent

Ruft die Eigenschaft ab, die angibt, ob DependencyProperty ein Ereignis-Delegate ist.Gets the property that indicates whether the DependencyProperty is an event Delegate.

Name Name Name Name

Ruft den Name von DependencyProperty ab.Gets the Name of the DependencyProperty.

OwnerType OwnerType OwnerType OwnerType

Ruft den Type von DependencyProperty ab.Gets the Type of the DependencyProperty.

PropertyType PropertyType PropertyType PropertyType

Ruft den Type des in DependencyProperty gespeicherten Werts ab.Gets the Type of the value stored in the DependencyProperty.

ValidatorType ValidatorType ValidatorType ValidatorType

Ruft den Type ab, der eine Validierungslogik implementiert, die spezifisch für DependencyProperty ist.Gets the Type implementing validation logic specific to the DependencyProperty.

Methoden

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)
FromName(String, Type) FromName(String, Type) FromName(String, Type) FromName(String, Type)

Ruft die registrierte DependencyProperty auf Grundlage von Name und OwnerType ab.Gets the registered DependencyProperty based on the Name and OwnerType.

FromType(Type) FromType(Type) FromType(Type) FromType(Type)

Erstellt eine IList vom Typ DependencyProperty, die zu einem bestimmten Type gehört.Creates an IList of type DependencyProperty that belong to a specific Type.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

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

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Register(String, Type, Type) Register(String, Type, Type) Register(String, Type, Type) Register(String, Type, Type)

Initialisiert eine neue Instanz der DependencyProperty-Klasse, in der die Eigenschaften gemäß den Eingabeparametern parametrisiert sind.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

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

Initialisiert eine neue Instanz der DependencyProperty-Klasse, in der die Eigenschaften gemäß den Eingabeparametern parametrisiert sind.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

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

Initialisiert eine neue Instanz der DependencyProperty-Klasse, in der die Eigenschaften gemäß den Eingabeparametern parametrisiert sind.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters. Diese Instanz ist für das Deklarieren von Eigenschaften vorgesehen, die nicht für Objekte des übergeordneten Typs verwendet werden.This instance is intended to declare properties that are used on objects other than the objects of owning type.

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

Initialisiert eine neue Instanz der DependencyProperty-Klasse, in der die Eigenschaften gemäß den Eingabeparametern parametrisiert sind.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

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

Initialisiert eine neue Instanz der DependencyProperty-Klasse, in der die Eigenschaften gemäß den Eingabeparametern parametrisiert sind.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

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

Überschreibt die Object-Methode, um den Name-Eigenschaftswert zurückzugeben.Overrides the Object method to return the Name property value.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.Populates a SerializationInfo with the data required to serialize the target object.

Gilt für: