CommunicationException 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:

CommunicationException.cs

Představuje chybu komunikace ve službě nebo klientské aplikaci.

public ref class CommunicationException : Exception

public class CommunicationException : Exception

type CommunicationException = class
    inherit Exception

Public Class CommunicationException
Inherits Exception

Dědičnost

Object

Exception

CommunicationException

Odvozené

System.ServiceModel.ActionNotSupportedException

System.ServiceModel.AddressAccessDeniedException

System.ServiceModel.AddressAlreadyInUseException

System.ServiceModel.Channels.RedirectionException

System.ServiceModel.Channels.RetryException

System.ServiceModel.ChannelTerminatedException

System.ServiceModel.CommunicationObjectAbortedException

System.ServiceModel.CommunicationObjectFaultedException

System.ServiceModel.Dispatcher.MessageFilterException

System.ServiceModel.EndpointNotFoundException

System.ServiceModel.FaultException

System.ServiceModel.Persistence.PersistenceException

System.ServiceModel.PoisonMessageException

System.ServiceModel.ProtocolException

System.ServiceModel.Security.MessageSecurityException

System.ServiceModel.Security.SecurityAccessDeniedException

System.ServiceModel.Security.SecurityNegotiationException

System.ServiceModel.ServerTooBusyException

System.ServiceModel.ServiceActivationException

Příklady

Následující příklad kódu ukazuje klienta, který zpracovává CommunicationException typy. Tento klient také zpracovává FaultException objekty, protože služba je nastavena IncludeExceptionDetailInFaults na true.

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

Robustní klientské aplikace a aplikace WCF (Windows Communication Foundation) zpracovávají CommunicationException objekty, které mohou být vyvolány během komunikace. Existují také dva CommunicationExceptiontypy výjimek odvozené odvozované (FaultException<TDetail> a FaultException), které klienti také často očekávají. Proto, aby se zabránilo obecné CommunicationException obslužné rutině zachytit tyto konkrétnější typy výjimek, zachyťte tyto výjimky před zpracováním CommunicationException.

• FaultException<TDetail> objekty jsou vyvolány v klientovi, pokud je přijata chyba SOAP, která je zadána v kontraktu operace v reakci na obousměrnou operaci (to znamená metoda s atributem s OperationContractAttributeIsOneWay nastaveným na false).

FaultException objekty jsou vyvolány, když naslouchací proces obdrží chybu SOAP, která není očekávaná nebo určena v kontraktu operace. K tomu obvykle dochází, když je aplikace laděna a služba má vlastnost nastavena IncludeExceptionDetailInFaults na true.

Poznámka:

Při implementaci vlastních kanálů a vazeb prvků důrazně doporučujeme, aby komponenty házely pouze System.TimeoutException nebo CommunicationExceptionodvozené objekty. V případě, že součásti vyvolá obnovitelnou výjimku, která je specifická pro danou komponentu, zabalte tuto výjimku uvnitř objektu CommunicationException .

Další podrobnosti o návrhu a používání systému selhání WCF naleznete v tématu Určení a zpracování chyb v kontraktech a službách.

Důležité

Modul runtime WCF nevyvolá CommunicationException nebezpečné zpracování v okamžiku, kdy opustí modul runtime WCF a zadá uživatelský kód.

Konstruktory

Name	Description
CommunicationException()	Inicializuje novou instanci CommunicationException třídy.
CommunicationException(SerializationInfo, StreamingContext)	Inicializuje novou instanci CommunicationException třídy pomocí zadaných serializačních informací a kontextových objektů.
CommunicationException(String, Exception)	Inicializuje novou instanci CommunicationException třídy pomocí zadané zprávy a vnitřní výjimky.
CommunicationException(String)	Inicializuje novou instanci CommunicationException třídy pomocí zadané zprávy.