CommunicationException Klasse

Definition

public ref class CommunicationException : Exception

public ref class CommunicationException : SystemException

public class CommunicationException : Exception

[System.Serializable]
public class CommunicationException : SystemException

type CommunicationException = class
    inherit Exception

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

Public Class CommunicationException
Inherits Exception

Public Class CommunicationException
Inherits SystemException

Vererbung

Object

Exception

CommunicationException

Vererbung

Object

Exception

SystemException

CommunicationException

Abgeleitet

System.ServiceModel.ActionNotSupportedException

System.ServiceModel.AddressAccessDeniedException

System.ServiceModel.AddressAlreadyInUseException

System.ServiceModel.Channels.RedirectionException

System.ServiceModel.Channels.RetryException

Mehr …

Attribute

SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird ein Client gezeigt, der CommunicationException-Typen verarbeitet. Dieser Client verarbeitet auch FaultException-Objekte, da beim Dienst IncludeExceptionDetailInFaults auf true festgelegt ist.

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

Hinweise

Robuste Client- und Dienst-Windows Communication Foundation (WCF)-Anwendungen behandeln CommunicationException Objekte, die während der Kommunikation ausgelöst werden können. Es gibt auch zwei von CommunicationException abgeleitete Ausnahmetypen (FaultException<TDetail> und FaultException), die häufig von Clients erwartet werden. Um daher zu verhindern, dass der generische CommunicationException-Handler diese spezifischeren Ausnahmetypen abfängt, müssen die Ausnahmen vor der Verarbeitung von CommunicationException abgefangen werden.

• FaultException<TDetail> Objekte werden auf dem Client ausgelöst, wenn ein SOAP-Fehler, der im Vorgangsvertrag angegeben ist, als Antwort auf einen zweiwegigen Vorgang empfangen wird (das heißt, eine Methode mit einem OperationContractAttribute Attribut IsOneWay mit Set auf false).

FaultException Objekte werden ausgelöst, wenn ein Listener einen SOAP-Fehler empfängt, der im Vorgangsvertrag nicht erwartet oder angegeben ist. Dies tritt in der Regel auf, wenn für die Anwendung ein Debugvorgang durchgeführt wird und die IncludeExceptionDetailInFaults-Eigenschaft des Diensts auf true festgelegt wurde.

Weitere Informationen zum Entwerfen und Verwenden des WCF-Fehlersystems finden Sie unter Angeben und Behandeln von Fehlern in Verträgen und Diensten.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für