CommunicationException Osztály

Definíció

Névtér:

System.ServiceModel

Szerelvények:

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

Csomag:

System.ServiceModel.Primitives v10.0.652802

Forrás:

CommunicationException.cs

Kommunikációs hibát jelöl a szolgáltatásban vagy az ügyfélalkalmazásban.

public ref class CommunicationException : Exception

public class CommunicationException : Exception

type CommunicationException = class
    inherit Exception

Public Class CommunicationException
Inherits Exception

Öröklődés

Object

Exception

CommunicationException

Származtatott

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éldák

Az alábbi példakód egy típusokat kezelő ügyfelet CommunicationException mutat be. Ez az ügyfél az objektumokat FaultException is kezeli, mert a szolgáltatás a következőre IncludeExceptionDetailInFaultsvan true állítva: .

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

Megjegyzések

A robusztus ügyfél- és szolgáltatás Windows kommunikációs alaprendszer (WCF) alkalmazások CommunicationException objektumokat kezelnek, amelyeket a kommunikáció során dobhatnak el. Két származtatott kivételtípus is CommunicationExceptionlétezik (FaultException<TDetail> és FaultException), amelyeket az ügyfelek is gyakran elvárnak. Ezért annak érdekében, hogy az általános CommunicationException kezelő ne tudja elkapni ezeket a speciálisabb kivételtípusokat, a kezelés CommunicationExceptionelőtt fogja el ezeket a kivételeket.

• FaultException<TDetail> objektumok akkor kerülnek az ügyfélre, ha a műveleti szerződésben megadott SOAP-hiba kétirányú műveletre (azaz egy olyan metódusra) reagál, amelynek OperationContractAttribute az attribútuma IsOneWay a következőre van állítva false: ).

FaultException objektumokat a rendszer akkor dob ki, ha a figyelő olyan SOAP-hibát kap, amely nem várható vagy nincs megadva a műveleti szerződésben. Ez általában akkor fordul elő, ha az alkalmazás hibakeresése folyamatban van, és a szolgáltatás tulajdonsága a IncludeExceptionDetailInFaults következőre truevan állítva: .

Note

Egyéni csatornák és kötéselemek megvalósításakor erősen ajánlott, hogy az összetevők csak vagy System.TimeoutExceptionszármaztatott CommunicationException objektumokat dobjanak. Abban az esetben, ha az összetevők az összetevőre jellemző helyreállítható kivételt eredményeznek, csomagolja be a kivételt egy CommunicationException objektumba.

A WCF-hibarendszer tervezésével és használatával kapcsolatos további részletekért lásd: Szerződések és szolgáltatások hibáinak megadása és kezelése.

Important

A WCF-futtatókörnyezet nem fog olyan hibát dobni CommunicationException , amelyet nem biztonságos kezelni azon a ponton, ahol elhagyja a WCF-futtatókörnyezetet, és beírja a felhasználói kódot.

Konstruktorok

Name	Description
CommunicationException()	Inicializálja a CommunicationException osztály új példányát.
CommunicationException(SerializationInfo, StreamingContext)	Inicializálja az CommunicationException osztály új példányát a megadott szerializálási információk és környezetobjektumok használatával.
CommunicationException(String, Exception)	Inicializálja az CommunicationException osztály új példányát a megadott üzenet és a belső kivétel használatával.
CommunicationException(String)	Inicializálja az CommunicationException osztály új példányát a megadott üzenet használatával.