CommunicationException Clase

Definición

Espacio de nombres:

System.ServiceModel

Ensamblados:

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

Paquete:

System.ServiceModel.Primitives v10.0.652802

Source:

CommunicationException.cs

Representa un error de comunicación en el servicio o en la aplicación cliente.

public ref class CommunicationException : Exception

public class CommunicationException : Exception

type CommunicationException = class
    inherit Exception

Public Class CommunicationException
Inherits Exception

Herencia

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

Ejemplos

En el ejemplo de código siguiente se muestra un cliente que controla los CommunicationException tipos. Este cliente también controla FaultException los objetos porque el servicio se ha IncludeExceptionDetailInFaults establecido en 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

Comentarios

Las aplicaciones sólidas de Windows Communication Foundation (WCF) de cliente y servicio controlan CommunicationException los objetos que se pueden producir durante la comunicación. También hay dos CommunicationExceptiontipos de excepción derivados (FaultException<TDetail> y FaultException) que los clientes también esperan a menudo. Por lo tanto, para evitar que el controlador genérico CommunicationException capture estos tipos de excepciones más específicos, capture estas excepciones antes de controlar CommunicationException.

• FaultException<TDetail> Los objetos se inician en el cliente cuando se recibe un error soap especificado en el contrato de operación en respuesta a una operación bidireccional (es decir, un método con un OperationContractAttribute atributo con IsOneWay establecido en false).

FaultException Los objetos se inician cuando un agente de escucha recibe un error soap que no se espera o se especifica en el contrato de operación. Esto suele ocurrir cuando se depura la aplicación y el servicio tiene la IncludeExceptionDetailInFaults propiedad establecida trueen .

Nota:

Al implementar canales personalizados y elementos de enlace, se recomienda encarecidamente que los componentes inicien solo System.TimeoutException objetos derivados o CommunicationException. En caso de que los componentes produzcan una excepción recuperable específica del componente, encapsula esa excepción dentro de un CommunicationException objeto .

Para obtener más información sobre cómo diseñar y usar el sistema de errores de WCF, vea Especificación y control de errores en contratos y servicios.

Importante

El tiempo de ejecución de WCF no iniciará un CommunicationException que no es seguro para controlar en el punto en el que sale del tiempo de ejecución de WCF y escribe el código de usuario.

Constructores

Nombre	Description
CommunicationException()	Inicializa una nueva instancia de la clase CommunicationException.
CommunicationException(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la CommunicationException clase utilizando la información de serialización y los objetos de contexto especificados.
CommunicationException(String, Exception)	Inicializa una nueva instancia de la CommunicationException clase utilizando el mensaje especificado y la excepción interna.
CommunicationException(String)	Inicializa una nueva instancia de la CommunicationException clase utilizando el mensaje especificado.