要弃用的类型和成员 (C++/CX)

C++/CX 支持使用 Deprecated 特性弃用生成者和使用者的 Windows 运行时类型和成员。 如果你使用具有此特性的 API,会收到编译时警告消息。 它指示该 API 已弃用,还建议使用替代 API。 在你自己的公共类型和方法中,可应用此特性并提供自己的自定义消息。

注意

Deprecated 特性只适用于 Windows 运行时类型。 对于标准 C++ 类和成员,请使用 [[deprecated]](C++14 和更高版本)或 __declspec(deprecated)

示例

下面的示例演示如何弃用你自己的公共 API(例如 Windows 运行时组件中的公共 API)。 类型 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
event
method
property
struct field

delegate
enum field
interface
参数化构造函数
struct
XAML 控件

另请参阅

类型系统 (C++/CX)
C++/CX 语言参考
命名空间参考