Platform::Exception 클래스Platform::Exception Class

애플리케이션 실행 중에 발생하는 오류를 나타냅니다.Represents errors that occur during application execution. 사용자 지정 예외 클래스는 Platform::Exception에서 파생될 수 없습니다.Custom exception classes can't be derived from Platform::Exception. 사용자 지정 예외가 필요한 경우 Platform::COMException 을 사용하고 앱 관련 HRESULT를 지정할 수 있습니다.If you require a custom exception, you can use Platform::COMException and specify an app-specific HRESULT.

구문Syntax

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

멤버Members

Exception 클래스는 Object 클래스 및 IException, IPrintable, IEquatable 인터페이스에서 상속됩니다.The Exception class inherits from the Object class and the IException, IPrintable, and IEquatable interfaces.

Exception 클래스에는 다음과 같은 종류의 멤버도 있습니다.The Exception class also has the following kinds of members.

생성자Constructors

멤버Member DescriptionDescription
예외:: ExceptionException::Exception Exception 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Exception class.

메서드Methods

Exception클래스는 Equals() Finalize() GetHashCode() GetType() MemberwiseClose() ToString() Platform:: Object 클래스에서,,,, 및 메서드를 상속 합니다.The Exception class inherits the Equals(), Finalize(),GetHashCode(),GetType(),MemberwiseClose(), and ToString() methods from the Platform::Object Class. Exception 클래스에는 다음 메서드도 있습니다.The Exception class also has the following method.

멤버Member DescriptionDescription
예외:: CreateExceptionException::CreateException 지정된 HRESULT 값을 나타내는 예외를 만듭니다.Creates an exception that represents the specified HRESULT value.

속성Properties

Exception 클래스에는 다음과 같은 속성도 있습니다.The Exception class also has the following properties.

멤버Member DescriptionDescription
예외:: HResultException::HResult 예외에 해당하는 HRESULT입니다.The HRESULT that corresponds to the exception.
예외:: MessageException::Message 예외를 설명하는 메시지입니다.A message that describes the exception. 이 값은 읽기 전용이며 Exception 이 생성된 후 수정될 수 없습니다.This value is read-only and cannot be modified after the Exception is constructed.

요구 사항Requirements

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

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

네임스페이스: PlatformNamespace: Platform

메타 데이터: platform.objectMetadata: platform.winmd

Exception:: CreateException 메서드Exception::CreateException Method

지정된 HRESULT 값에서 Platform::Exception^을 만듭니다.Creates a Platform::Exception^ from a specified HRESULT value.

구문Syntax

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

매개 변수Parameters

시간hr
일반적으로 COM 메서드 호출에서 가져오는 HRESULT 값입니다.An HRESULT value that you typically get from a call to a COM method. 값이 0이 고 S_OK와 같으면이 메서드는 성공 하는 COM 메서드가 예외를 throw 하지 않아야 하므로 Platform:: InvalidArgumentException 을 throw 합니다.If the value is 0, which is equal to S_OK, this method throws Platform::InvalidArgumentException because COM methods that succeed should not throw exceptions.

messagemessage
오류를 설명하는 문자열입니다.A string that describes the error.

반환 값Return Value

오류 HRESULT를 나타내는 예외입니다.An exception that represents the error HRESULT.

설명Remarks

예를 들어 COM 인터페이스 메서드에 대한 호출에서 반환되는 HRESULT에서 예외를 만들려면 이 메서드를 사용합니다.Use this method to create an exception out of an HRESULT that is returned, for example, from a call to a COM interface method. String^ 매개 변수를 사용하는 오버로드를 사용하여 사용자 지정 메시지를 제공할 수 있습니다.You can use the overload that takes a String^ parameter to provide a custom message.

단순히 HRESULT를 포함 하는 Platform:: COMException 를 만드는 대신 createexception을 사용 하 여 강력한 형식의 예외를 만드는 것이 좋습니다.It is strongly recommended to use CreateException to create a strongly-typed exception rather than creating a Platform::COMException that merely contains the HRESULT.

Exception:: Exception 생성자Exception::Exception Constructor

Exception 클래스의 새 인스턴스를 초기화합니다.Intializes a new instance of the Exception class.

구문Syntax

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

매개 변수Parameters

hresulthresult
예외로 표시되는 오류 HRESULT입니다.The error HRESULT that is represented by the exception.

messagemessage
예외와 관련된 지침 텍스트와 같은 사용자 지정 메시지입니다.A user-specified message, such as prescriptive text, that is associated with the exception. 일반적으로 오류 발생 이유와 그 방법에 대해 최대한 구체적인 설명 메시지를 제공하기 위해서는 두 번째 오버로드를 사용하는 것이 좋습니다.In general you should prefer the second overload in order to provide a descriptive message that is as specific as possible about how and why the error has occurred.

Exception:: HResult 속성Exception::HResult Property

예외에 해당하는 HRESULT입니다.The HRESULT that corresponds to the exception.

SyntaxSyntax

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

속성 값Property Value

HRESULT 값입니다.An HRESULT value.

설명Remarks

대부분의 예외는 HRESULT 값으로 반환되는 COM 오류로 시작합니다.Most exceptions start out as COM errors, which are returned as HRESULT values. C++/CX가 이러한 값을 Platform::Exception^ 개체로 변환하고, 이 속성이 원래 오류 코드의 값을 저장합니다.C++/CX converts these values into Platform::Exception^ objects, and this property stores the value of the original error code.

Exception:: Message 속성Exception::Message Property

오류를 설명하는 메시지입니다.Message that describes the error.

SyntaxSyntax

public:property String^ Message;

속성 값Property Value

Windows 런타임에서 발생하는 예외의 경우, 이것은 오류에 대한 시스템 제공 설명입니다.In exceptions that originate in the Windows Runtime, this is a system-supplied description of the error.

설명Remarks

Windows 8에서이 속성은 해당 버전의 Windows 런타임에 대 한 예외가 ABI에서 HRESULT로만 전송 되기 때문에 읽기 전용입니다.In Windows 8, this property is read-only because exceptions in that version of the Windows Runtime are transported across the ABI only as HRESULTS. Windows 8.1에서는 다양한 예외 정보가 ABI 전체에 전송되며 다른 구성 요소에서 프로그래밍 방식으로 액세스할 수 있는 사용자 지정 메시지를 제공할 수 있습니다.In Windows 8.1, richer exception information is transported across the ABI and you can provide a custom message that other components can access programmatically. 자세한 내용은 예외 (c + +/cx)를 참조 하세요.For more information, see Exceptions (C++/CX).

추가 정보See also

Platform 네임스페이스Platform namespace