將類型和成員設為已被取代 (C++/CX)
C++/CX 支援使用 Deprecated
屬性,將生產者和消費者的 Windows 執行階段類型和成員設為已被取代。 如果您使用具有這個屬性的 API,您會收到編譯時期警告訊息。 這表示 API 已被取代,也建議使用替代的 API。 在您的公用類型和方法,可以套用這個屬性並提供自訂訊息。
警告
Deprecated
屬性僅適用於 Windows 執行階段類型。 針對標準 C++ 類別和成員,請使用 [[deprecated]]
(C++14 和更新版本) 或 __declspec(deprecated)
。
範例
下列範例示範如何 (例如在 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 控制項