CommunicationException Kelas

Definisi

Ruang nama:

System.ServiceModel

Rakitan:

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

Paket:

System.ServiceModel.Primitives v10.0.652802

Sumber:

CommunicationException.cs

Mewakili kesalahan komunikasi dalam layanan atau aplikasi klien.

public ref class CommunicationException : Exception

public class CommunicationException : Exception

type CommunicationException = class
    inherit Exception

Public Class CommunicationException
Inherits Exception

Warisan

Object

Exception

CommunicationException

Turunan

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

Contoh

Contoh kode berikut menunjukkan klien yang menangani CommunicationException jenis. Klien ini juga menangani FaultException objek karena layanan telah IncludeExceptionDetailInFaults diatur ke 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

Keterangan

Aplikasi Windows Communication Foundation (WCF) klien dan layanan yang kuat menangani CommunicationException objek yang mungkin dilemparkan selama komunikasi. Ada juga dua CommunicationExceptionjenis pengecualian turunan (FaultException<TDetail> dan FaultException) yang juga sering diharapkan klien. Oleh karena itu, untuk mencegah handler generik CommunicationException menangkap jenis pengecualian yang lebih spesifik ini, tangkap pengecualian ini sebelum menangani CommunicationException.

• FaultException<TDetail> objek dilemparkan pada klien ketika kesalahan SOAP yang ditentukan dalam kontrak operasi diterima sebagai respons terhadap operasi dua arah (yaitu, metode dengan atribut dengan OperationContractAttributeIsOneWay diatur ke false).

FaultException objek dilemparkan ketika pendengar menerima kesalahan SOAP yang tidak diharapkan atau ditentukan dalam kontrak operasi. Ini biasanya terjadi ketika aplikasi sedang di-debug dan layanan memiliki properti yang IncludeExceptionDetailInFaults diatur ke true.

Nota

Saat menerapkan saluran kustom dan elemen pengikatan, sangat disarankan agar komponen Anda hanya System.TimeoutException melemparkan atau CommunicationException-turunan objek. Dalam kasus di mana komponen Anda melemparkan pengecualian yang dapat dipulihkan yang khusus untuk komponen, bungkus pengecualian itu di dalam CommunicationException objek.

Untuk detail selengkapnya tentang merancang dan menggunakan sistem kesalahan WCF, lihat Menentukan dan Menangani Kesalahan dalam Kontrak dan Layanan.

Penting

Runtime WCF tidak akan melempar CommunicationException yang tidak aman untuk ditangani pada titik di mana ia meninggalkan Runtime WCF dan memasukkan kode pengguna.

Konstruktor

Nama	Deskripsi
CommunicationException()	Menginisialisasi instans baru dari kelas CommunicationException.
CommunicationException(SerializationInfo, StreamingContext)	Menginisialisasi instans CommunicationException baru kelas, menggunakan informasi serialisasi dan objek konteks yang ditentukan.
CommunicationException(String, Exception)	Menginisialisasi instans CommunicationException baru kelas, menggunakan pesan yang ditentukan dan pengecualian dalam.
CommunicationException(String)	Menginisialisasi instans CommunicationException baru kelas, menggunakan pesan yang ditentukan.