Attributs (C++/CX)

  • Article

Un attribut est un type spécial de classe ref qui peut être ajouté entre crochets aux types et méthodes Windows Runtime pour spécifier certains comportements dans la création de métadonnées. Plusieurs attributs prédéfinis( par exemple, Windows ::Foundation ::Metadata ::WebHostHidden) sont couramment utilisés dans le code C++/CX. Cet exemple montre comment l'attribut est appliqué à une classe :

[Windows::Foundation::Metadata::WebHostHidden]
public ref class MyClass : Windows::UI::Xaml::DependencyObject {};

Attributs personnalisés

Vous pouvez également définir des attributs personnalisés. Les attributs personnalisés doivent être conformes à ces règles Windows Runtime :

  • Les attributs personnalisés ne peuvent contenir que des champs publics.

  • Les champs d'attributs personnalisés peuvent être initialisés lorsque l'attribut est appliqué à une classe.

  • Un champ peut être l'un de ces types :

    • int32 (entier)

    • uint32 (entier non signé)

    • bool

    • Platform::String^

    • Windows::Foundation::HResult

    • Platform::Type^

    • classe Enum publique (inclut des énumérations définies par l'utilisateur)

L'exemple suivant indique comment définir un attribut personnalisé et l'initialiser pour l'utiliser.

[Windows::Foundation::Metadata::WebHostHiddenAttribute]
public ref class MyCustomAttribute sealed : Platform::Metadata::Attribute {
public:
    int Num;
    Platform::String^ Msg;
};

[MyCustomAttribute(Num=5, Msg="Hello")]
public ref class Class1 sealed
{
public:
    Class1();
};

Voir aussi

Système de type (C++/CX)
Informations de référence sur le langage C++/CX
Référence aux espaces de noms