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(), GetType(), MemberwiseClose()및 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)를 참조하세요.