CommunicationException Sınıf

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kodlar:

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

Paket:

System.ServiceModel.Primitives v10.0.652802

Kaynak:

CommunicationException.cs

Hizmet veya istemci uygulamasındaki bir iletişim hatasını temsil eder.

public ref class CommunicationException : Exception

public class CommunicationException : Exception

type CommunicationException = class
    inherit Exception

Public Class CommunicationException
Inherits Exception

Devralma

Object

Exception

CommunicationException

Türetilmiş

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

Örnekler

Aşağıdaki kod örneği, türleri işleyen CommunicationException bir istemciyi gösterir. Hizmet olarak ayarlandığından IncludeExceptionDetailInFaultstrue, bu istemci nesneleri de işlerFaultException.

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

Açıklamalar

Sağlam istemci ve hizmet Windows Communication Foundation (WCF) uygulamaları, iletişim sırasında oluşturulabilecek nesneleri işler CommunicationException . İstemcilerin de genellikle beklediği iki CommunicationExceptiontüretilmiş özel durum türü (FaultException<TDetail> ve FaultException) vardır. Bu nedenle, genel CommunicationException işleyicinin bu daha belirli özel özel durum türlerini yakalamasını önlemek için, işlemeden CommunicationExceptionönce bu özel durumları yakalayın.

• FaultException<TDetail>nesneleri, işlem sözleşmesinde belirtilen bir SOAP hatası iki yönlü bir işleme (yani, değerine ayarlanmış özniteliği IsOneWay olan bir OperationContractAttribute yöntem) yanıt olarak alındığında istemcide falseoluşturulur.

FaultException nesneler, bir dinleyici işlem sözleşmesinde beklenmeyen veya belirtilmeyen bir SOAP hatası aldığında oluşturulur. Bu durum genellikle uygulama hata ayıklanırken ve hizmet IncludeExceptionDetailInFaults özelliği olarak trueayarlandığında oluşur.

Uyarı

Özel kanalları ve bağlama öğelerini uygularken, bileşenlerinizin yalnızca System.TimeoutException veya CommunicationExceptiontüretilmiş nesneler oluşturması kesinlikle önerilir. Bileşenlerinizin bileşene özgü kurtarılabilir bir özel durum oluşturması durumunda, bu özel durumu bir CommunicationException nesnenin içine sarmalar.

WCF hata sistemini tasarlama ve kullanma hakkında daha fazla ayrıntı için bkz. Sözleşmelerde ve Hizmetlerde Hataları Belirtme ve İşleme.

Önemli

WCF Çalışma Zamanı, WCF Çalışma Zamanı'nı bıraktığı ve kullanıcı kodunu girdiği noktada işlenmek üzere güvenli olmayan bir CommunicationException oluşturmaz.

Oluşturucular

Name	Description
CommunicationException()	CommunicationException sınıfının yeni bir örneğini başlatır.
CommunicationException(SerializationInfo, StreamingContext)	Belirtilen serileştirme bilgilerini ve bağlam nesnelerini kullanarak sınıfının yeni bir örneğini CommunicationException başlatır.
CommunicationException(String, Exception)	Belirtilen iletiyi ve iç özel durumu kullanarak sınıfının yeni bir örneğini CommunicationException başlatır.
CommunicationException(String)	Belirtilen iletiyi kullanarak sınıfının yeni bir örneğini CommunicationException başlatır.