Einstufen von Typen und Membern als veraltet (C++/CX)
C++/CX unterstützt das Veraltet von Windows-Runtime Typen und Membern für Produzenten und Consumer mithilfe 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 methodn können Sie dieses Attribut anwenden und Ihre eigene benutzerdefinierte Nachricht bereitstellen.
Achtung
Das Deprecated
Attribut dient nur für Windows-Runtime Typen. Verwenden Sie [[deprecated]]
für C++class-Standard-Es 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 veraltet oder entfernt wird. Derzeit wird nur der DeprecationType::Deprecated
Wert unterstützt. Der dritte Parameter im Attribut gibt das Windows::Foundation::Metadata::Platform
Attribut an, auf das 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 sind die Consstructaufgeführt, auf die das Deprecated
Attribut angewendet werden kann:
class
enum
event
method
property
struct field
delegate
enum field
interface
parametrisierte Constructoder
struct
XAML-Steuerelement
Siehe auch
Typsystem (C++/CX)
C++-/CX-Sprachreferenz
Namespaces-Referenz
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für