共用方式為


將類型和成員設為已被取代 (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 控制項

另請參閱

類型系統 (C++/CX)
C++/CX 語言參考
命名空間參考