FaultException Klas

Definitie

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

public class FaultException : System.ServiceModel.CommunicationException

[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))]
[System.Serializable]
public class FaultException : System.ServiceModel.CommunicationException

type FaultException = class
    inherit CommunicationException

[<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))>]
[<System.Serializable>]
type FaultException = class
    inherit CommunicationException

Public Class FaultException
Inherits CommunicationException

Overname

Object

Exception

CommunicationException

FaultException

Overname

Object

Exception

SystemException

CommunicationException

FaultException

Afgeleid

System.ServiceModel.FaultException<TDetail>

System.ServiceModel.Web.WebFaultException

Kenmerken

KnownTypeAttribute SerializableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van een try/catch-blok voor het vangen en verwerken FaultException van objecten die zijn gegenereerd vanuit een service. Dit gebeurt vaak wanneer foutopsporing is ingeschakeld in de servicetoepassing.

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

Opmerkingen

Gebruik in een service de FaultException klasse om een niet-getypte fout te maken om terug te keren naar de client voor foutopsporingsdoeleinden.

In een client vangen FaultException objecten voor het afhandelen van onbekende of algemene fouten, zoals die worden geretourneerd door een service waarvoor de IncludeExceptionDetailInFaults eigenschap is ingesteld op true. Omdat FaultException het uitbreidt CommunicationException, moet u alle FaultException objecten vangen voordat u objecten ophaalt CommunicationException als u ze afzonderlijk wilt vangen.

Over het algemeen wordt het sterk aanbevolen om uw FaultContractAttribute services te ontwerpen om sterk getypte SOAP-fouten (en niet beheerde uitzonderingsobjecten) te retourneren voor alle foutcases waarin u besluit dat de client foutinformatie vereist. Gebruik echter de FaultException volgende situaties:

• SOAP-fouten verzenden vanuit een service voor foutopsporing.

• Soap-fouten op een client ondervangen wanneer de fouten geen deel uitmaken van het servicecontract.

Objecten genereren FaultException wanneer u wilt dat de tekenreeks wordt doorgegeven aan de constructor en door de client wordt opgehaald door de FaultException<TDetail>.ToString methode aan te roepen. Als u een foutcontract opgeeft van het type System.ServiceModel.FaultException<TDetail> waar de typeparameter zich bevindt System.String, is de tekenreekswaarde beschikbaar als eigenschap FaultException<TDetail>.Detail en niet door aan te roepen FaultException<TDetail>.ToString.

Zie Opgeven en verwerken van fouten in contracten en services voor meer informatie.