ConstructorArgumentAttribute Klasse

Referenz

Definition

Namespace:: System.Windows.Markup

Assembly:: WindowsBase.dll

Assembly:: System.Xaml.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt an, dass ein Objekt mit der Syntax eines nicht parameterlosen Konstruktors initialisiert werden kann und dass eine Eigenschaft mit dem angegebenen Namen Informationen zur Erstellung bereitstellt. Diese Informationen sind in erster Linie für die XAML-Serialisierung vorgesehen.

public ref class ConstructorArgumentAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)]
public sealed class ConstructorArgumentAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)>]
type ConstructorArgumentAttribute = class
    inherit Attribute

Public NotInheritable Class ConstructorArgumentAttribute
Inherits Attribute

Vererbung: Object

Attribute
ConstructorArgumentAttribute

Attribute: AttributeUsageAttribute

Hinweise

Dieses Attribut gibt an, dass die zugeordnete Eigenschaft durch einen Konstruktorparameter initialisiert werden kann und bei der XAML-Serialisierung ignoriert werden soll, wenn der Konstruktor zum Erstellen der instance verwendet wird. Dies bietet bessere Roundtripdarstellungen für parametrisierte Konstruktorsyntax als die parameterlose Konstruktorinstanziierung und bestimmte Attribute.

Ein Framework kann möglicherweise die Beibehaltung von Markuperweiterungsverwendungen und deren Wiederherstellung unterstützen, anstatt sich für die Serialisierung auf ProvideValue die Ausgabe in der Objektstruktur zu verlassen. In diesem Fall sind die Informationen während der ConstructorArgumentAttribute Serialisierung nützlich, um eine genaue Darstellung der typischen Verwendung von Markuperweiterungen zu erzeugen. Weitere Informationen zur Markuperweiterungen finden Sie unter Markup Extensions for XAML Overview.

Um für eine ConstructorArgumentAttribute Zuordnung gültig zu sein, muss der öffentliche nicht parameterlose Konstruktor eines Typs genau einen Parameter unterstützen. Der Name des Parameters muss einer Lese-/Schreibeigenschaft entsprechen. Die Eigenschaft muss andernfalls serialisierbar sein. Sie verwenden dieses Attribut, um die Übereinstimmung zwischen dem Namen des Parameters im Konstruktor und der -Eigenschaft zu erstellen. Insbesondere wenden Sie dieses Attribut auf die Definition auf Eigenschaftsebene der Verbindungseigenschaft mit Lese-/Schreibzugriff an.

Consumer von ConstructorArgumentAttribute können in Fällen auslösen, in denen ArgumentName die Typsicherung nicht aufgelöst wird, oder wenn sie auf einen Typ angewendet wird, der nicht über die geeigneten Konstruktionsargumente und Arität verfügt.

In früheren Versionen der .NET Framework war diese Klasse in der WPF-spezifischen Assembly WindowsBase vorhanden. In .NET Framework 4 ConstructorArgumentAttribute befindet sich in der System.Xaml-Assembly. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.

Hinweise zur WPF-Verwendung

Weitere Informationen zu Markuperweiterungen und WPF finden Sie unter Markuperweiterungen und WPF-XAML.

Konstruktoren

ConstructorArgumentAttribute(String)

Initialisiert eine neue Instanz der ConstructorArgumentAttribute-Klasse.

Eigenschaften

ArgumentName	Ruft den Namensparameter des Konstruktors ab, der die zugeordnete Eigenschaft initialisiert.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für: