ConstructorArgumentAttribute Classe

Definizione

Specifica che un oggetto può essere inizializzato mediante una sintassi del costruttore non senza parametri e che una proprietà con il nome specificato fornisce informazioni sulla costruzione. Queste informazioni sono utili principalmente per la serializzazione 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
Ereditarietà
ConstructorArgumentAttribute
Attributi

Commenti

Questo attributo specifica che la proprietà associata può essere inizializzata da un parametro del costruttore e deve essere ignorata per la serializzazione XAML se il costruttore viene usato per costruire l'istanza. In questo modo vengono fornite rappresentazioni di round trip migliori per la sintassi del costruttore con parametri anziché l'istanza del costruttore senza parametri e attributi specifici.

Un framework può potenzialmente supportare la conservazione degli usi delle estensioni di markup e la ricostituzione anziché basarsi sull'output ProvideValue nell'albero degli oggetti per la serializzazione. In questo caso, le informazioni sono utili durante la ConstructorArgumentAttribute serializzazione per produrre una rappresentazione accurata dell'utilizzo tipico dell'estensione di markup. Per ulteriori informazioni sulle estensioni di markup, vedere Markup Extensions for XAML Overview.

Per essere validi per un'attribuzione, il costruttore pubblico non con parametri di un ConstructorArgumentAttribute tipo deve supportare esattamente un parametro. Il nome del parametro deve corrispondere a una proprietà di lettura/scrittura. La proprietà deve essere altrimenti serializzabile. Usare questo attributo per creare la corrispondenza tra il nome del parametro nel costruttore e la proprietà. In particolare, si applica questo attributo alla definizione a livello di proprietà della proprietà di connessione della proprietà di lettura/scrittura.

I consumatori di ConstructorArgumentAttribute possono generare nei casi in cui ArgumentName non si risolve il backing di tipi o quando applicato a un tipo che non ha gli argomenti di costruzione appropriati e arity.

Nelle versioni precedenti di .NET Framework, questa classe esiste nell'assembly specifico di WPF WindowsBase. In .NET Framework 4 ConstructorArgumentAttribute si trova nell'assembly System.Xaml. Per altre informazioni, vedere Types Migrated from WPF to System.Xaml.

Note sull'utilizzo di WPF

Per altre informazioni sulle estensioni di markup e WPF, vedere Estensioni di markup e XAML WPF.

Costruttori

ConstructorArgumentAttribute(String)

Inizializza una nuova istanza della classe ConstructorArgumentAttribute.

Proprietà

ArgumentName

Ottiene il parametro del nome del costruttore che inizializzerà la proprietà associata.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.

(Ereditato da Attribute)

Si applica a

Vedi anche