형식 및 멤버가 사용되지 않도록 지정(C++/CX)
C++/CX는 Deprecated
특성을 사용하여 생산자와 소비자를 위한 Windows Runtime 형식 및 멤버의 사용 중단을 지원합니다. 이 특성이 있는 API를 사용하는 경우 컴파일 시간 경고 메시지가 표시됩니다. API가 더 이상 사용되지 않음을 나타내며 대체해서 사용할 API도 권장합니다. public 형식 및 메서드에서 이 특성을 적용하고 사용자 지정 메시지를 제공할 수 있습니다.
주의
이 Deprecated
특성은 Windows Runtime 형식에만 사용됩니다. 표준 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
이벤트
method
property
struct field
delegate
enum field
interface
매개 변수가 있는 생성자
struct
XAML 컨트롤