FaultException Třída

Definice

Obor názvů:

System.ServiceModel

Sestavení:

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

Balíček:

System.ServiceModel.Primitives v10.0.652802

Zdroj:

FaultException.cs

Představuje chybu 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

Dědičnost

Object

Exception

CommunicationException

FaultException

Odvozené

System.ServiceModel.FaultException<TDetail>

System.ServiceModel.Web.WebFaultException

Atributy

SerializableAttribute

Příklady

Následující příklad kódu ukazuje použití bloku try/catch k zachycení a zpracování FaultException objektů vyvolaných ze služby. K tomu často dochází při zapnutí ladění v aplikaci služby.

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

Poznámky

Ve službě pomocí FaultException třídy vytvořte netypovou chybu, která se vrátí klientovi pro účely ladění.

V klientovi zachyťte FaultException objekty pro zpracování neznámých nebo obecných chyb, jako jsou například ty vrácené službou s vlastností nastavenou IncludeExceptionDetailInFaults na true. Vzhledem k tomu FaultException , že rozšíření CommunicationException, nezapomeňte zachytit všechny FaultException objekty před zachycením CommunicationException objektů, pokud je chcete zachytit samostatně.

Poznámka:

Duplexní služby mohou také zachytit FaultException objekty vrácené z jejich interakce s duplexním klientem.

Obecně se důrazně doporučuje navrhnout FaultContractAttribute služby tak, aby vracely chyby SOAP se silnými typy (a ne spravované objekty výjimek) pro všechny případy selhání, ve kterých se rozhodnete, že klient vyžaduje informace o chybách. Použijte FaultException však následující situace:

• Odesílání chyb PROTOKOLU SOAP ze služby pro účely ladění

• Chcete-li zachytit chyby SOAP na klientovi, pokud chyby nejsou součástí kontraktu služby.

Vyvolá FaultException objekty, pokud chcete, aby byl řetězec předán konstruktoru a načten klient voláním FaultException<TDetail>.ToString metody. Pokud zadáte kontrakt chyby typu System.ServiceModel.FaultException<TDetail> , kde je System.Stringparametr typu , řetězcová hodnota je k dispozici jako FaultException<TDetail>.Detail vlastnost, a ne voláním FaultException<TDetail>.ToString.

Podrobnosti najdete v tématu Určení a zpracování chyb v kontraktech a službách.

Konstruktory

Name	Description
FaultException()	Inicializuje novou instanci FaultException třídy.
FaultException(FaultReason, FaultCode, String)	Inicializuje novou instanci FaultException třídy pomocí zadaného důvodu, kódu chyby a hodnoty akce.
FaultException(MessageFault, String)	Inicializuje novou instanci FaultException třídy pomocí zadaných chybových hodnot zprávy a zadaného řetězce akce.
FaultException(SerializationInfo, StreamingContext)	Inicializuje novou instanci FaultException třídy pomocí zadaných serializačních informací a kontextu při deserializaci datového proudu do objektu FaultException .
FaultException(String)	Inicializuje novou instanci FaultException třídy se zadaným důvodem chyby.

Vlastnosti

Name	Description
Action	Získá hodnotu akce SOAP pro chybovou zprávu.
Code	Získá kód chyby pro chybu SOAP.
Message	Získá zprávu pro výjimku.
Reason	FaultReason Získá chybu SOAP.

Metody

Name	Description
CreateFault(MessageFault, String, Type[])	FaultException Vrátí objekt ze zadané chyby zprávy, akce a pole typů podrobností.
CreateFault(MessageFault, Type[])	FaultException Vrátí objekt ze zadané chyby zprávy a pole typů podrobností.
CreateMessageFault()	Vrátí objekt MessageFault.