要弃用的类型和成员 (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 控件
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈