Platform::Exception 클래스

  • 아티클

애플리케이션을 실행할 때 나타나는 오류를 나타냅니다. 사용자 지정 예외 클래스는 Platform::Exception에서 파생될 수 없습니다. 사용자 지정 예외가 필요한 경우 Platform::COMException 을 사용하고 앱 관련 HRESULT를 지정할 수 있습니다.

구문

public ref class Exception : Object,    IException,    IPrintable,    IEquatable

멤버

Exception 클래스는 Object 클래스 및 IException, IPrintable, IEquatable 인터페이스에서 상속됩니다.

Exception 클래스에는 다음과 같은 종류의 멤버도 있습니다.

생성자

멤버 설명
예외::예외 Exception 클래스의 새 인스턴스를 초기화합니다.

메서드

클래스는 Exception Platform::Object 클래스에서 , Finalize(),GetHashCode()MemberwiseClose()GetType(), 및 ToString() 메서드를 상속Equals()합니다. Exception 클래스에는 다음 메서드도 있습니다.

멤버 설명
예외::CreateException 지정된 HRESULT 값을 나타내는 예외를 만듭니다.

속성

Exception 클래스에는 다음과 같은 속성도 있습니다.

멤버 설명
예외::HResult 예외에 해당하는 HRESULT입니다.
예외::Message 예외를 설명하는 메시지입니다. 이 값은 읽기 전용이며 Exception 이 생성된 후 수정될 수 없습니다.

요구 사항

지원되는 최소 클라이언트: Windows 8

지원되는 최소 서버: Windows Server 2012

네임스페이스: Platform

메타데이터: platform.winmd

Exception::CreateException 메서드

지정된 HRESULT 값에서 Platform::Exception^을 만듭니다.

구문

Exception^ CreateException(int32 hr);
Exception^ CreateException(int32 hr, Platform::String^ message);

매개 변수

Hr
일반적으로 COM 메서드 호출에서 가져오는 HRESULT 값입니다. 값이 S_OK 같은 0이면 성공하는 COM 메서드가 예외를 throw해서는 안 되므로 이 메서드는 Platform::InvalidArgumentException을 throw합니다.

message
오류를 설명하는 문자열입니다.

Return Value

오류 HRESULT를 나타내는 예외입니다.

설명

예를 들어 COM 인터페이스 메서드에 대한 호출에서 반환되는 HRESULT에서 예외를 만들려면 이 메서드를 사용합니다. String^ 매개 변수를 사용하는 오버로드를 사용하여 사용자 지정 메시지를 제공할 수 있습니다.

단순히 HRESULT를 포함하는 Platform::COMException을 만드는 대신 CreateException을 사용하여 강력한 형식의 예외를 만드는 것이 좋습니다.

Exception::Exception 생성자

Exception 클래스의 새 인스턴스를 초기화합니다.

구문

Exception(int32 hresult);
Exception(int32 hresult, ::Platform::String^ message);

매개 변수

hresult
예외로 표시되는 오류 HRESULT입니다.

message
예외와 관련된 지침 텍스트와 같은 사용자 지정 메시지입니다. 일반적으로 오류 발생 이유와 그 방법에 대해 최대한 구체적인 설명 메시지를 제공하기 위해서는 두 번째 오버로드를 사용하는 것이 좋습니다.

Exception::HResult 속성

예외에 해당하는 HRESULT입니다.

구문

public:
    property int HResult { int get(); }

속성 값

HRESULT 값입니다.

설명

대부분의 예외는 HRESULT 값으로 반환되는 COM 오류로 시작합니다. C++/CX가 이러한 값을 Platform::Exception^ 개체로 변환하고, 이 속성이 원래 오류 코드의 값을 저장합니다.

Exception::Message 속성

오류를 설명하는 메시지입니다.

구문

public:property String^ Message;

속성 값

Windows 런타임에서 발생하는 예외의 경우, 이것은 오류에 대한 시스템 제공 설명입니다.

설명

Windows 8에서는 해당 버전의 Windows 런타임 예외가 ABI에서 HRESULTS로만 전송되기 때문에 이 속성은 읽기 전용입니다. Windows 8.1에서는 다양한 예외 정보가 ABI 전체에 전송되며 다른 구성 요소에서 프로그래밍 방식으로 액세스할 수 있는 사용자 지정 메시지를 제공할 수 있습니다. 자세한 내용은 예외(C++/CX)를 참조하세요.

참고 항목

Platform 네임스페이스