Freigeben über


Attribute (C++/CX)

Ein Attribut ist eine spezielle Art von Verweisklasse, die in eckigen Klammern vorkonfiguriert werden kann, um Windows-Runtime Typen und Methoden festzulegen, um bestimmte Verhaltensweisen bei der Metadatenerstellung anzugeben. Mehrere vordefinierte Attribute, z . B. Windows::Foundation::Metadata::WebHostHidden, werden häufig in C++/CX-Code verwendet. Dieses Beispiel zeigt, wie das Attribut auf eine Klasse angewendet wird:

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

Benutzerdefinierte Attribute

Sie können auch benutzerdefinierte Attribute definieren. Benutzerdefinierte Attribute müssen diesen Windows-Runtime Regeln entsprechen:

  • Benutzerdefinierte Attribute können nur öffentliche Felder enthalten.

  • Benutzerdefinierte Attributfelder können initialisiert werden, wenn das Attribut auf eine Klasse angewendet wird.

  • Ein Feld kann einer dieser Typen sein:

    • int32 (int)

    • uint32 (int ohne Vorzeichen)

    • bool

    • Platform::String^

    • Windows::Foundation::HResult

    • Platform::Type^

    • öffentliche Enumerationsklasse (enthält benutzerdefinierte Enumerationen)

Das nächste Beispiel zeigt, wie ein benutzerdefiniertes Attribut definiert und anschließend zur Verwendung initialisiert wird.

[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();
};

Siehe auch

Typsystem (C++/CX)
C++-/CX-Programmiersprachenreferenz
Referenz zu Namespaces