Поделиться через

Перевод типов и членов в разряд нерекомендуемых (C++/CX)

  • Статья

C++/CX поддерживает отмену среда выполнения Windows типов и членов для производителей и потребителей с помощью атрибутаDeprecated. Если вы используете API с этим атрибутом, вы получите предупреждение во время компиляции. Он указывает, что API не рекомендуется использовать, а также рекомендует альтернативный API. В собственных открытых типах и методах вы можете применять этот атрибут с заданием своего сообщения.

Внимание

Атрибут Deprecated предназначен только для среда выполнения Windows типов. Для стандартных классов и членов C++ используйте [[deprecated]] (C++14 и более поздних версий) или __declspec(deprecated).

Пример

В следующем примере показано, как переводить в число нерекомендуемых собственные открытые API, например в компоненте среды выполнения Windows. Второй параметр типа Windows:Foundation::Metadata::DeprecationType указывает, является ли API устаревшим или удаленным. В настоящее время поддерживается только DeprecationType::Deprecated значение. Третий параметр в атрибуте указывает, Windows::Foundation::Metadata::Platform к чему применяется атрибут.

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

Поддерживаемые целевые объекты

В следующей таблице перечислены конструкции, к которым Deprecated может применяться атрибут:

class
enum
события
method
property
struct field

delegate
enum field
interface
параметризованный конструктор
struct
элемент управления XAML

См. также

Система типов (C++/CX)
Справочник по языку C++/CX
Справочник по пространствам имен