ConstructorArgumentAttribute Classe

Définition

Espace de noms:

System.Windows.Markup

Assembly:

System.Xaml.dll

Spécifie qu’un objet peut être initialisé au moyen d’une syntaxe de constructeur autre qu’un constructeur sans paramètre, et qu’une propriété du nom spécifié fournit les informations de construction. Ces informations sont principalement destinées à la sérialisation XAML.

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

Héritage

Object

Attribute

ConstructorArgumentAttribute

Attributs

AttributeUsageAttribute

Remarques

Cet attribut spécifie que la propriété associée peut être initialisée par un paramètre de constructeur et doit être ignorée pour la sérialisation XAML si le constructeur est utilisé pour construire le instance. Cela fournit de meilleures représentations aller-retour pour la syntaxe de constructeur paramétrable plutôt que l’instanciation du constructeur sans paramètre avec des attributs spécifiques.

Une infrastructure peut potentiellement prendre en charge la préservation des utilisations des extensions de balisage et leur reconstitution au lieu de s’appuyer sur ProvideValue la sortie dans l’arborescence d’objets pour la sérialisation. Dans ce cas, les informations sont utiles pendant la ConstructorArgumentAttribute sérialisation pour produire une représentation exacte de l’utilisation classique de l’extension de balisage. Pour plus d’informations sur les extensions de balisage, consultez Markup Extensions for XAML Overview.

Pour être valide pour une ConstructorArgumentAttribute attribution, le constructeur public non sans paramètre d’un type doit prendre en charge exactement un paramètre. Le nom du paramètre doit correspondre à une propriété en lecture/écriture. Sinon, la propriété doit être sérialisable. Vous utilisez cet attribut pour créer la correspondance entre le nom du paramètre dans le constructeur et la propriété . Plus précisément, vous appliquez cet attribut à la définition de niveau propriété de la propriété de connexion en lecture/écriture.

Les consommateurs de ConstructorArgumentAttribute peuvent lever dans les cas où ArgumentName ne se résout pas en type de sauvegarde, ou lorsqu’il est appliqué à un type qui n’a pas les arguments de construction et l’arité appropriés.

Dans les versions précédentes du .NET Framework, cette classe existait dans l’assembly windowsBase spécifique à WPF. Dans .NET Framework 4, ConstructorArgumentAttribute se trouve dans l’assembly System.Xaml. Pour plus d'informations, consultez Types Migrated from WPF to System.Xaml.

Remarques sur l'utilisation de WPF

Pour plus d’informations sur les extensions de balisage et WPF, consultez Extensions de balisage et XAML WPF.

Constructeurs

ConstructorArgumentAttribute(String)

Initialise une nouvelle instance de la classe ConstructorArgumentAttribute.

Propriétés

ArgumentName	Obtient le paramètre de nom du constructeur qui initialisera la propriété associée.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• MarkupExtension
• Attributs CLR liés au XAML pour les types et bibliothèques personnalisés
• Définir des types personnalisés à utiliser avec les services XAML .NET
• Services XAML
• Convertisseurs de types et extensions de balisage pour XAML