CommunicationException Classe

Definição

Namespace:

System.ServiceModel

Assemblies:

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

Pacote:

System.ServiceModel.Primitives v10.0.652802

Origem:

CommunicationException.cs

Representa um erro de comunicação no serviço ou no aplicativo cliente.

public ref class CommunicationException : Exception

public class CommunicationException : Exception

type CommunicationException = class
    inherit Exception

Public Class CommunicationException
Inherits Exception

Herança

Object

Exception

CommunicationException

Derivado

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

Exemplos

O exemplo de código a seguir mostra um cliente que manipula tipos CommunicationException . Esse cliente também manipula FaultException objetos porque o serviço foi IncludeExceptionDetailInFaults definido como 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

Comentários

Aplicativos WCF (Windows Communication Foundation) robustos e de serviço manipulam CommunicationException objetos que podem ser gerados durante a comunicação. Há também dois CommunicationExceptiontipos de exceção derivados (FaultException<TDetail> e FaultException) que os clientes também costumam esperar. Portanto, para impedir que o manipulador genérico CommunicationException capture esses tipos de exceção mais específicos, capture essas exceções antes do tratamento CommunicationException.

• FaultException<TDetail> os objetos são lançados no cliente quando uma falha SOAP especificada no contrato de operação é recebida em resposta a uma operação bidirecional (ou seja, um método com um OperationContractAttribute atributo com IsOneWay definido como false).

FaultException os objetos são gerados quando um ouvinte recebe uma falha SOAP que não é esperada ou especificada no contrato de operação. Isso geralmente ocorre quando o aplicativo está sendo depurado e o serviço tem a IncludeExceptionDetailInFaults propriedade definida como true.

Observação

Ao implementar canais personalizados e elementos de associação, é altamente recomendável que seus componentes lancem somente System.TimeoutException ou CommunicationExceptionobjetos derivados. No caso em que seus componentes geram uma exceção recuperável específica ao componente, encapsule essa exceção dentro de um CommunicationException objeto.

Para obter mais detalhes sobre como projetar e usar o sistema de falhas do WCF, consulte Especificando e tratando falhas em contratos e serviços.

Importante

O Runtime do WCF não lançará um CommunicationException que não seja seguro para lidar no ponto em que ele sai do WCF Runtime e insere o código do usuário.

Construtores

Nome	Description
CommunicationException()	Inicializa uma nova instância da classe CommunicationException.
CommunicationException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da CommunicationException classe usando as informações de serialização especificadas e objetos de contexto.
CommunicationException(String, Exception)	Inicializa uma nova instância da CommunicationException classe, usando a mensagem especificada e a exceção interna.
CommunicationException(String)	Inicializa uma nova instância da CommunicationException classe usando a mensagem especificada.