FaultException Clase

Definición

Espacio de nombres:

System.ServiceModel

Ensamblados:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v10.0.652802

Source:

FaultException.cs

Representa un error soap.

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

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

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

Public Class FaultException
Inherits CommunicationException

Herencia

Object

Exception

CommunicationException

FaultException

Derivado

System.ServiceModel.FaultException<TDetail>

System.ServiceModel.Web.WebFaultException

Atributos

SerializableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de un bloque try/catch para detectar y controlar FaultException objetos producidos desde un servicio. Esto suele ocurrir cuando la depuración está activada en la aplicación de servicio.

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

Comentarios

En un servicio, use la FaultException clase para crear un error sin tipo para volver al cliente con fines de depuración.

En un cliente, capture FaultException objetos para controlar errores desconocidos o genéricos, como los devueltos por un servicio con la IncludeExceptionDetailInFaults propiedad establecida en true. Dado que FaultException extiende CommunicationException, recuerde capturar los FaultException objetos antes de capturar objetos si desea capturarlos CommunicationException por separado.

Nota:

Los servicios dúplex también pueden detectar FaultException objetos devueltos de su interacción con un cliente dúplex.

En general, se recomienda encarecidamente usar FaultContractAttribute para diseñar los servicios para devolver errores SOAP fuertemente tipados (y no objetos de excepción administrados) para todos los casos de error en los que decida que el cliente requiere información de error. Sin embargo, use en FaultException las situaciones siguientes:

• Para enviar errores SOAP desde un servicio con fines de depuración.

• Para detectar errores soap en un cliente cuando los errores no forman parte del contrato de servicio.

Inicie FaultException objetos cuando quiera que la cadena se pase al constructor y la recupere el cliente llamando al FaultException<TDetail>.ToString método . Si especifica un contrato de error de tipo System.ServiceModel.FaultException<TDetail> donde el parámetro de tipo es System.String, el valor de cadena está disponible como la FaultException<TDetail>.Detail propiedad y no llamando a FaultException<TDetail>.ToString.

Para obtener más información, consulte Especificación y control de errores en contratos y servicios.

Constructores

Nombre	Description
FaultException()	Inicializa una nueva instancia de la clase FaultException.
FaultException(FaultReason, FaultCode, String)	Inicializa una nueva instancia de la FaultException clase utilizando el motivo, el código de error y el valor de acción especificados.
FaultException(MessageFault, String)	Inicializa una nueva instancia de la FaultException clase utilizando los valores de error de mensaje especificados y la cadena de acción proporcionada.
FaultException(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la FaultException clase utilizando la información de serialización y el contexto especificados al deserializar una secuencia en un FaultException objeto .
FaultException(String)	Inicializa una nueva instancia de la FaultException clase con el motivo de error especificado.

Propiedades

Nombre	Description
Action	Obtiene el valor de la acción SOAP para el mensaje de error.
Code	Obtiene el código de error del error soap.
Message	Obtiene el mensaje de la excepción.
Reason	Obtiene para FaultReason el error soap.

Métodos

Nombre	Description
CreateFault(MessageFault, String, Type[])	Devuelve un FaultException objeto del error de mensaje, la acción y una matriz de tipos de detalle especificados.
CreateFault(MessageFault, Type[])	Devuelve un FaultException objeto del error de mensaje especificado y una matriz de tipos de detalle.
CreateMessageFault()	Devuelve un objeto MessageFault.