ConstructorArgumentAttribute Klasse

Definition

Gibt an, dass ein Objekt mithilfe einer nicht parameterlosen Konstruktorsyntax initialisiert werden kann und dass eine Eigenschaft des angegebenen Namens Konstruktionsinformationen bereitstellt. Diese Informationen dienen in erster Linie der XAML-Serialisierung.

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
ConstructorArgumentAttribute
Attribute

Hinweise

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

Ein Framework kann möglicherweise die Beibehaltung von Markuperweiterungsverwendungen unterstützen und sie konstituieren, anstatt sich auf ProvideValue die Ausgabe in der Objektstruktur für die Serialisierung zu verlassen. In diesem Fall ist die Information während der ConstructorArgumentAttribute Serialisierung nützlich, um eine genaue Darstellung der typischen Markuperweiterungsverwendung zu erzeugen. Weitere Informationen zu Markuperweiterungen finden Sie unter Markuperweiterungen für XAML (Übersicht).

Um für eine Zuordnung gültig zu sein, muss der öffentliche nicht parameterlose Konstruktor eines ConstructorArgumentAttribute 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 Korrespondenz zwischen dem Namen des Parameters im Konstruktor und der Eigenschaft zu erstellen. Insbesondere wenden Sie dieses Attribut auf die Definition der Verbindungseigenschaft mit Lese-/Schreibzugriff an.

Verbraucher können ConstructorArgumentAttribute in Fällen ausgelöst werden, in denen ArgumentName die Typsicherung nicht aufgelöst wird, oder wenn sie auf einen Typ angewendet wird, der nicht über die entsprechenden Konstruktionsargumente und -arität verfügt.

In früheren Versionen von .NET Framework war diese Klasse in der WPF-spezifischen Assembly WindowsBase vorhanden. In .NET Framework 4 ConstructorArgumentAttribute befindet sich die System.Xaml-Assembly. Weitere Informationen finden Sie unter "Von WPF zu System.Xaml migrierte Typen".

WPF-Verwendungshinweise

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

Konstruktoren

Name Beschreibung
ConstructorArgumentAttribute(String)

Initialisiert eine neue Instanz der ConstructorArgumentAttribute-Klasse.

Eigenschaften

Name Beschreibung
ArgumentName

Ruft den Namensparameter des Konstruktors ab, der die zugeordnete Eigenschaft initialisiert.

TypeId

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute.

(Geerbt von Attribute)

Methoden

Name Beschreibung
Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name Beschreibung
_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 denen 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)

Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden.

(Geerbt von Attribute)

Gilt für:

Weitere Informationen