Sdílet prostřednictvím

Vyřazování typů a členů (C++/CX)

  • Článek

C++/CX podporuje vyřazení typů prostředí Windows Runtime a členů pro producenty a uživatele pomocí atributuDeprecated. Pokud používáte rozhraní API s tímto atributem, zobrazí se zpráva s upozorněním na dobu kompilace. Označuje, že rozhraní API je zastaralé a také doporučuje alternativní rozhraní API, které se má použít. Ve vlastních veřejných typech a metodách můžete použít tento atribut a zadat vlastní zprávu.

Upozornění

Atribut Deprecated se používá pouze s typy prostředí Windows Runtime. Pro standardní třídy a členy jazyka C++ použijte [[deprecated]] (C++14 a novější) nebo __declspec(deprecated).

Příklad

Následující příklad ukazuje, jak zastarat vlastní veřejná rozhraní API – například v prostředí Windows Runtime komponentě. Druhý parametr typu Windows:Foundation::Metadata::DeprecationType určuje, jestli je rozhraní API zastaralé nebo odebrané. V současné době se podporuje pouze DeprecationType::Deprecated hodnota. Třetí parametr v atributu určuje Windows::Foundation::Metadata::Platform , na který se atribut vztahuje.

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

Podporované cíle

Následující tabulka uvádí konstrukty, na které Deprecated lze atribut použít:

class
enum
event
method
property
struct field

delegate
enum field
interface
parametrizovaný konstruktor
struct
Ovládací prvek XAML

Viz také

Systém typů (C++/CX)
Referenční dokumentace jazyka C++/CX
Referenční informace k oborům názvů