FaultException Класс

Определение

public ref class FaultException : System::ServiceModel::CommunicationException

public class FaultException : System.ServiceModel.CommunicationException

[System.Serializable]
public class FaultException : System.ServiceModel.CommunicationException

[System.Serializable]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultCodeData[]))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultReasonData[]))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultCodeData))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultReasonData))]
public class FaultException : System.ServiceModel.CommunicationException

type FaultException = class
    inherit CommunicationException

[<System.Serializable>]
type FaultException = class
    inherit CommunicationException

[<System.Serializable>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultCodeData[]))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultReasonData[]))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultCodeData))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.FaultException+FaultReasonData))>]
type FaultException = class
    inherit CommunicationException

Public Class FaultException
Inherits CommunicationException

Наследование

Object

Exception

CommunicationException

FaultException

Наследование

Object

Exception

SystemException

CommunicationException

FaultException

Производный

System.ServiceModel.FaultException<TDetail>

System.ServiceModel.Web.WebFaultException

Атрибуты

SerializableAttribute KnownTypeAttribute

Примеры

В следующем примере кода показано, как использовать блок try/catch для перехвата и обработки объектов FaultException, вызванных службой. Это часто происходит при включении отладки в приложении службы.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using Microsoft.WCF.Documentation;

public class Client
{
  public static void Main()
  {
    // Picks up configuration from the configuration file.
    SampleServiceClient wcfClient = new SampleServiceClient();
    try
    {
      // Making calls.
      Console.WriteLine("Enter the greeting to send: ");
      string greeting = Console.ReadLine();
      Console.WriteLine("The service responded: " + wcfClient.SampleMethod(greeting));
      Console.WriteLine("Press ENTER to exit:");
      Console.ReadLine();
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      wcfClient.Abort();
      Console.ReadLine();
    }
    // Catch the contractually specified SOAP fault raised here as an exception.
    catch (FaultException<GreetingFault> greetingFault)
    {
      Console.WriteLine(greetingFault.Detail.Message);
      Console.Read();
      wcfClient.Abort();
    }
    // Catch unrecognized faults. This handler receives exceptions thrown by WCF
    // services when ServiceDebugBehavior.IncludeExceptionDetailInFaults
    // is set to true.
    catch (FaultException faultEx)
    {
      Console.WriteLine("An unknown exception was received. "
        + faultEx.Message
        + faultEx.StackTrace
      );
      Console.Read();
      wcfClient.Abort();
    }
    // Standard communication fault handler.
    catch (CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message + commProblem.StackTrace);
      Console.Read();
      wcfClient.Abort();
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports Microsoft.WCF.Documentation

Public Class Client
  Public Shared Sub Main()
    ' Picks up configuration from the configuration file.
    Dim wcfClient As New SampleServiceClient()
    Try
      ' Making calls.
      Console.WriteLine("Enter the greeting to send: ")
      Dim greeting As String = Console.ReadLine()
      Console.WriteLine("The service responded: " & wcfClient.SampleMethod(greeting))
      Console.WriteLine("Press ENTER to exit:")
      Console.ReadLine()
    Catch timeProblem As TimeoutException
      Console.WriteLine("The service operation timed out. " & timeProblem.Message)
      wcfClient.Abort()
      Console.ReadLine()
    ' Catch the contractually specified SOAP fault raised here as an exception.
    Catch greetingFault As FaultException(Of GreetingFault)
      Console.WriteLine(greetingFault.Detail.Message)
      Console.Read()
      wcfClient.Abort()
    ' Catch unrecognized faults. This handler receives exceptions thrown by WCF
    ' services when ServiceDebugBehavior.IncludeExceptionDetailInFaults 
    ' is set to true.
    Catch faultEx As FaultException
      Console.WriteLine("An unknown exception was received. " & faultEx.Message + faultEx.StackTrace)
      Console.Read()
      wcfClient.Abort()
    ' Standard communication fault handler.
    Catch commProblem As CommunicationException
      Console.WriteLine("There was a communication problem. " & commProblem.Message + commProblem.StackTrace)
      Console.Read()
      wcfClient.Abort()
    End Try
  End Sub
End Class

Комментарии

В службе используйте класс FaultException, чтобы создать нетипизированную ошибку для возврата клиенту для отладки.

В клиенте перехватите объект FaultException, чтобы обработать неизвестные или универсальные ошибки, например ошибки, возвращаемые службой, свойству IncludeExceptionDetailInFaults которой присвоено значение true. Поскольку FaultException расширяет CommunicationException, не забудьте перехватить все объекты FaultException до перехвата объектов CommunicationException, если их необходимо перехватить по отдельности.

Как правило, настоятельно рекомендуется использовать атрибут FaultContractAttribute, чтобы службы возвращали строго типизированные ошибки SOAP (а не управляемые объекты исключений) во всех случаях возникновения ошибок, при которых было принято решение, что клиенту требуются сведения об ошибках. Однако используйте FaultException в следующих ситуациях.

• Отправка ошибок SOAP из службы для отладки.

• Захват ошибок SOAP на стороне клиента, если ошибки не являются частью контракта службы.

Создайте объекты FaultException, если строку необходимо передать в конструктор и извлечь с помощью клиента, вызвав метод FaultException<TDetail>.ToString. Если задан контракт сбоя, принадлежащий к типу System.ServiceModel.FaultException<TDetail>, с параметром типа System.String, значение строки доступно как свойство FaultException<TDetail>.Detail, а не за счет вызова FaultException<TDetail>.ToString.

Дополнительные сведения см. в разделе Указание и обработка ошибок в контрактах и службах.

Конструкторы

Свойства

Методы

События

Применяется к