CommunicationException クラス

定義

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

継承

Object

Exception

CommunicationException

継承

Object

Exception

SystemException

CommunicationException

派生

System.ServiceModel.ActionNotSupportedException

System.ServiceModel.AddressAccessDeniedException

System.ServiceModel.AddressAlreadyInUseException

System.ServiceModel.Channels.RedirectionException

System.ServiceModel.Channels.RetryException

その他…

属性

SerializableAttribute

例

次のコード例は、 CommunicationException 型を処理するクライアントを示しています。 このクライアントは、サービスFaultExceptionIncludeExceptionDetailInFaultsに設定されているため、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

注釈

堅牢なクライアントとサービスの Windows Communication Foundation (WCF) アプリケーションは、通信中にスローされる可能性のある CommunicationException オブジェクトを処理します。 また、クライアントが期待する CommunicationException派生例外の種類 (FaultException<TDetail> と FaultException) も 2 つあります。 そのため、ジェネリック CommunicationException ハンドラーがこれらのより具体的な例外の種類をキャッチしないようにするには、 CommunicationExceptionを処理する前にこれらの例外をキャッチします。

• FaultException<TDetail>オブジェクトは、操作コントラクトで指定された SOAP エラーが双方向操作 (つまり、OperationContractAttributeが IsOneWay に設定されたfalse属性を持つメソッド) に応答して受信されると、クライアントでスローされます。

FaultException オブジェクトは、予期されていない SOAP エラーまたは操作コントラクトで指定された SOAP エラーをリスナーが受信するとスローされます。 これは通常、アプリケーションがデバッグ中で、サービスに IncludeExceptionDetailInFaults プロパティが true に設定されている場合に発生します。

WCF 障害システムの設計と使用の詳細については、「 コントラクトとサービスでのエラーの指定と処理」を参照してください。