要弃用的类型和成员 (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 控件