형식 및 멤버가 사용되지 않도록 지정(C++/CX)

C++/CX는 특성을 사용하여 생산자 및 소비자에 대한 Windows 런타임 형식 및 멤버의 사용 중단을 Deprecated 지원합니다. 이 특성이 있는 API를 사용하는 경우 컴파일 시간 경고 메시지가 표시됩니다. API가 더 이상 사용되지 않음을 나타내며 사용할 대체 API도 권장합니다. 사용자 고유의 공용 형식에서 method이 특성을 적용하고 고유한 사용자 지정 메시지를 제공할 수 있습니다.

주의

이 특성은 Deprecated Windows 런타임 형식에만 사용됩니다. 표준 C++ classes 및 멤버 [[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();
};

지원되는 대상

다음 표에서는 특성이 적용될 수 있는 단점struct을 Deprecated 나열합니다.

class
enum
event
method
property
struct field

delegate
enum field
interface
매개 변수가 있는 construct또는
struct
XAML 컨트롤

참고 항목

형식 시스템(C++/CX)
C++/CX 언어 참조
네임스페이스 참조