정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

FaultException<TDetail> 클래스

2013-12-13

계약에 의해 지정된 SOAP 오류를 catch하기 위해 클라이언트 응용프로그램에서 사용됩니다.

System.Object
  System.Exception
    System.SystemException
      System.ServiceModel.CommunicationException
        System.ServiceModel.FaultException
          System.ServiceModel.FaultException<TDetail>

Namespace:  System.ServiceModel
어셈블리:  System.ServiceModel(System.ServiceModel.dll)

public class FaultException<TDetail> : FaultException

형식 매개 변수

TDetail

직렬화 가능 오류 세부 정보 형식입니다.

FaultException<TDetail> 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드FaultException<TDetail>지정된 세부 정보 개체와 SOAP 오류 이유, 코드 및 동작 값을 사용하여 FaultException<TDetail> 클래스의 새 인스턴스를 초기화합니다.
맨 위

  이름설명
Public 속성Action오류 메시지에 대한 SOAP 동작의 값을 가져옵니다. (FaultException에서 상속됨)
Public 속성CodeSOAP 오류의 오류 코드를 가져옵니다. (FaultException에서 상속됨)
Public 속성Data예외에 대한 사용자 정의 추가 정보를 제공하는 키/값 쌍의 컬렉션을 가져옵니다. (Exception에서 상속됨)
Public 속성Detail오류 조건의 세부 정보가 포함된 개체를 가져옵니다.
Public 속성HelpLink이 예외와 관련된 도움말 파일에 대한 링크를 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성HResult특정 예외에 할당된 코드화된 숫자 값인 HRESULT를 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성InnerException현재 예외를 발생시킨 Exception 인스턴스를 가져옵니다. (Exception에서 상속됨)
Public 속성Message예외에 대한 메시지를 가져옵니다. (FaultException에서 상속됨)
Public 속성ReasonSOAP 오류의 FaultReason을 가져옵니다. (FaultException에서 상속됨)
Public 속성Source오류를 발생시키는 응용프로그램 또는 개체의 이름을 가져오거나 설정합니다. (Exception에서 상속됨)
Public 속성StackTrace현재 예외가 발생된 시간에 호출 스택의 프레임에 대한 문자열 표현을 가져옵니다. (Exception에서 상속됨)
맨 위

  이름설명
Public 메서드CreateMessageFault메모리 내 MessageFault 개체를 반환합니다. (FaultException에서 상속됨)
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetBaseException파생 클래스에서 재정의되었을 때, 하나 이상의 후속 예외의 근본 원인이 되는 Exception을 반환합니다. (Exception에서 상속됨)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 런타임 형식을 가져옵니다. (Exception에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToStringFaultException<TDetail> 개체에 대한 문자열을 반환합니다. (Exception.ToString()을(를) 재정의함)
맨 위

Windows Phone 클라이언트 응용프로그램에서 FaultException<TDetail> 개체를 catch하여 작업 계약에 지정된 SOAP 오류를 처리합니다.

대부분의 배포된 서비스는 FaultContractAttribute를 사용하여 클라이언트가 정상적인 작업 과정에서 받을 수 있는 모든 SOAP 오류를 공식적으로 지정합니다. FaultContractAttribute의 오류 정보는 클라이언트 응용프로그램에 도착할 때 FaultException<TDetail>으로 표시됩니다. 여기서 형식 매개 변수는 작업의 FaultContractAttribute에 지정된 직렬화 가능 오류 개체입니다. FaultContractAttribute를 사용하여 양방향 서비스 메서드와 비동기 메서드 쌍에 대해 SOAP 오류를 지정할 수 있습니다.

FaultException<TDetail>FaultException인 동시에 CommunicationException이므로 지정된 SOAP 오류를 catch하려면 FaultExceptionCommunicationException 형식 전에 FaultException<TDetail> 형식을 catch하거나 이러한 예외 처리기 중 하나에서 지정된 예외를 처리해야 합니다.

참고참고:

System.ServiceModel.FaultContractAttribute를 사용하여 형식 매개 변수가 System.StringFaultException<TDetail>을 지정하는 경우 문자열 값이 클라이언트 응용프로그램의 Detail에 할당됩니다. 클라이언트는 FaultException<TDetail>.ToString 메서드를 호출하여 해당 문자열을 검색할 수 없습니다. 클라이언트 응용프로그램이 Exception.ToString을 호출할 때 문자열 값이 반환되도록 하려면 작업 내부에서 System.ServiceModel.FaultException을 발생하고 문자열을 생성자에 전달합니다. 일반적으로 세부 정보 형식으로 System.String이 아니라 오류에 적합한 사용자 지정 직렬화 가능 형식을 사용하는 것이 좋습니다.

기능

앱에서 이 API를 사용하는 경우 앱 매니페스트에서 다음 기능을 지정해야 합니다. 그렇지 않으면 앱이 올바르게 작동하지 않거나 예기치 않게 종료될 수 있습니다.

ID_CAP_NETWORKING

Windows Phone 8, Windows Phone OS 7.1

자세한 내용은 Windows Phone의 앱 기능 및 하드웨어 요구 사항을 참조하세요.

다음 코드 예제는 서비스에서 FaultException<TDetail> 형식을 사용하여 FaultContractAttribute에 지정된 SOAP 오류로 변환되는 관리되는 예외를 발생하는 방법을 보여 줍니다.

다음 코드 예제는 클라이언트에서 SLsvcutil.exe를 사용하여 가져올 때 클라이언트 코드가 표시되는 모양을 보여 줍니다.

다음 코드 예제는 클라이언트에서 작업 계약에 지정된 사용자 지정 SOAP 오류를 나타내는 FaultException<TDetail> 형식을 catch할 수 있는 방법을 보여 줍니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수 있습니다.

표시: