Einstufen von Typen und Membern als veraltet (C++/CX)

C++/CX unterstützt die Veralterung von Windows Runtime-Typen und -Members für Producer und Consumer durch die Verwendung des Deprecated Attributs. Wenn Sie eine API mit diesem Attribut verwenden, erhalten Sie eine Warnmeldung zur Kompilierungszeit. Es weist darauf hin, dass die API veraltet ist, und empfiehlt außerdem eine alternative API für die Verwendung. In Ihren eigenen öffentlichen Typen und Methoden können Sie dieses Attribut anwenden und eine eigene benutzerdefinierte Meldung bereitstellen.

Achtung

Das Deprecated Attribut dient nur für Windows-Runtime Typen. Verwenden Sie [[deprecated]] für C++-Standardklassen und -Member (C++14 und höher) oder __declspec(deprecated).

Beispiel

Im folgenden Beispiel wird gezeigt, wie eine eigene öffentliche API – z. B. in einer Windows Runtime-Komponente als veraltet markiert wird. Der zweite Parameter vom Typ Windows:Foundation::Metadata::DeprecationType gibt an, ob die API als veraltet markiert oder entfernt wird. Der einzige derzeit unterstützte Wert ist DeprecationType::Deprecated. Der dritte Parameter im Attribut gibt an Windows::Foundation::Metadata::Platform, auf den das Attribut angewendet wird.

namespace wfm = Windows::Foundation::Metadata;

public ref class Bicycle sealed
{

public:
    property double Speed;

    [wfm::Deprecated("Use the Speed property to compute the angular speed of the wheel", wfm::DeprecationType::Deprecate, 0x0)]
    double ComputeAngularVelocity();
};

Unterstützte Ziele

In der folgenden Tabelle werden die Konstrukte aufgeführt, auf die das veraltete Deprecated Attribut angewendet werden kann:

class
enum
event
method
property
struct field

delegate
enum field
interface
parameterized constructor
struct
XAML-Steuerelement

Siehe auch

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