FaultException Classe

Definizione

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

Ereditarietà

Object

Exception

CommunicationException

FaultException

Ereditarietà

Object

Exception

SystemException

CommunicationException

FaultException

Derivato

System.ServiceModel.FaultException<TDetail>

System.ServiceModel.Web.WebFaultException

Attributi

SerializableAttribute KnownTypeAttribute

Esempio

Nell'esempio di codice seguente viene mostrato l'utilizzo di un blocco try/catch per rilevare e gestire oggetti FaultException generati da un servizio. Ciò si verifica spesso quando si attiva il debug nell'applicazione di servizio.

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

Commenti

Nei servizi, la classe FaultException può essere utilizzata per creare un errore non tipizzato da restituire al client per fini di debug.

Nei client, gli oggetti FaultException possono essere rilevati per gestire errori sconosciuti o generici, ad esempio quelli restituiti da un servizio in cui la proprietà IncludeExceptionDetailInFaults è impostata su true. Poiché la classe FaultException estende la classe CommunicationException, ricordarsi di rilevare qualsiasi oggetto FaultException prima di rilevare gli oggetti CommunicationException se si desidera rilevarli separatamente.

In generale, è consigliabile utilizzare l'attributo FaultContractAttribute per progettare i servizi in modo che restituiscano errori SOAP fortemente tipizzati (anziché oggetti eccezione non gestiti) per tutti i casi di errore in cui si desidera che il client richieda informazioni sull'errore. Nei casi elencati di seguito è tuttavia opportuno utilizzare l'eccezione FaultException:

• Invio di errori SOAP da un servizio per fini di debug.

• Rilevamento di errori SOAP su un client quando gli errori non appartengono al contratto di servizio.

Quando si desidera che la stringa venga passata al costruttore e recuperata dal client mediante una chiamata al metodo FaultException è possibile generare oggetti FaultException<TDetail>.ToString. Se si specifica un contratto di errore di tipo System.ServiceModel.FaultException<TDetail> in cui il parametro è di tipo System.String, per accedere al valore della stringa è possibile usare la proprietà FaultException<TDetail>.Detail e non il metodo FaultException<TDetail>.ToString.

Per informazioni dettagliate, vedere Specificare e gestire gli errori nei contratti e nei servizi.

Costruttori

Proprietà

Metodi

Eventi

Si applica a