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

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

注意

Deprecated 特性只适用于 Windows 运行时类型。 对于标准 C++ classes（类）和成员，请使用 [[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 特性的 constructs（构造）：

class
enum
event
method
property
struct field

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

另请参阅

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