ChannelFactory Klasa

Definicja

public ref class ChannelFactory abstract : System::ServiceModel::Channels::CommunicationObject, IDisposable, System::ServiceModel::Channels::IChannelFactory

public ref class ChannelFactory abstract : System::ServiceModel::Channels::CommunicationObject, IAsyncDisposable, IDisposable, System::ServiceModel::Channels::IChannelFactory

public abstract class ChannelFactory : System.ServiceModel.Channels.CommunicationObject, IDisposable, System.ServiceModel.Channels.IChannelFactory

public abstract class ChannelFactory : System.ServiceModel.Channels.CommunicationObject, IAsyncDisposable, IDisposable, System.ServiceModel.Channels.IChannelFactory

type ChannelFactory = class
    inherit CommunicationObject
    interface IDisposable
    interface IChannelFactory
    interface ICommunicationObject

type ChannelFactory = class
    inherit CommunicationObject
    interface IChannelFactory
    interface ICommunicationObject
    interface IDisposable
    interface IAsyncDisposable

type ChannelFactory = class
    inherit CommunicationObject
    interface IChannelFactory
    interface ICommunicationObject
    interface IDisposable

Public MustInherit Class ChannelFactory
Inherits CommunicationObject
Implements IChannelFactory, IDisposable

Public MustInherit Class ChannelFactory
Inherits CommunicationObject
Implements IAsyncDisposable, IChannelFactory, IDisposable

Dziedziczenie

Object

CommunicationObject

ChannelFactory

Pochodne

System.ServiceModel.ChannelFactory<TChannel>

Implementuje

IDisposable IChannelFactory ICommunicationObject IAsyncDisposable

Przykłady

Poniższy przykład kodu pokazuje, jak wstawić programowo zachowanie klienta przed utworzeniem obiektu kanału przez fabrykę.

public class Client
{
  public static void Main()
  {
    try
    {
      // Picks up configuration from the config file.
      ChannelFactory<ISampleServiceChannel> factory
        = new ChannelFactory<ISampleServiceChannel>("WSHttpBinding_ISampleService");

      // Add the client side behavior programmatically to all created channels.
      factory.Endpoint.Behaviors.Add(new EndpointBehaviorMessageInspector());

      ISampleServiceChannel wcfClientChannel = factory.CreateChannel();

      // Making calls.
      Console.WriteLine("Enter the greeting to send: ");
      string greeting = Console.ReadLine();
      Console.WriteLine("The service responded: " + wcfClientChannel.SampleMethod(greeting));

      Console.WriteLine("Press ENTER to exit:");
      Console.ReadLine();

      // Done with service.
      wcfClientChannel.Close();
      Console.WriteLine("Done!");
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      Console.Read();
    }
    catch (FaultException<SampleFault> fault)
    {
      Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage);
      Console.Read();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message);
      Console.Read();
    }
  }

Public Class Client
  Public Shared Sub Main()
    Try
      ' Picks up configuration from the config file.
      Dim factory As New ChannelFactory(Of ISampleServiceChannel)("WSHttpBinding_ISampleService")

      ' Add the client side behavior programmatically to all created channels.
      factory.Endpoint.Behaviors.Add(New EndpointBehaviorMessageInspector())

      Dim wcfClientChannel As ISampleServiceChannel = factory.CreateChannel()

      ' Making calls.
      Console.WriteLine("Enter the greeting to send: ")
            Dim greeting As String = Console.ReadLine()
      Console.WriteLine("The service responded: " & wcfClientChannel.SampleMethod(greeting))

      Console.WriteLine("Press ENTER to exit:")
      Console.ReadLine()

      ' Done with service. 
      wcfClientChannel.Close()
      Console.WriteLine("Done!")
    Catch timeProblem As TimeoutException
      Console.WriteLine("The service operation timed out. " & timeProblem.Message)
      Console.Read()
    Catch fault As FaultException(Of SampleFault)
      Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage)
      Console.Read()
    Catch commProblem As CommunicationException
      Console.WriteLine("There was a communication problem. " & commProblem.Message)
      Console.Read()
    End Try
  End Sub

Uwagi

Fabryki kanałów implementujące IChannelFactory interfejs i skojarzone z nimi kanały są zwykle używane przez inicjatorów wzorca komunikacji. Fabryki odbiorników, które implementują IChannelListener interfejs i skojarzone z nimi odbiorniki, zapewniają mechanizmy, z którymi kanały są akceptowane na potrzeby komunikacji.

Ta klasa nie jest częścią modelu kanału, ale modelu usługi. Metoda CreateFactory zapewnia metodę tworzenia IChannelFactory elementu dla punktu końcowego usługi. Służy do konstruowania klienta przyłączonego do kontraktu interfejsu w usłudze bez używania metadanych lub zasad.

Szczególna uwaga dla użytkowników zarządzanych języka C++ pochodnych z tej klasy:

• Umieść kod oczyszczania w kodzie (On)(Begin)Close (i/lub OnAbort), a nie w destruktorze.

• Unikaj destruktorów; powodują, że kompilator automatycznie generuje IDisposableelement .

• Unikaj elementów członkowskich niebędących odwołaniami; mogą spowodować, że kompilator automatycznie wygeneruje IDisposableelement .

• Unikaj używania finalizatora; ale jeśli je uwzględnisz, należy pominąć ostrzeżenie i wywołanie SuppressFinalize(Object) kompilacji oraz sam finalizator z (On)(Begin)Close (i/lub OnAbort), aby naśladować zachowanie generowane IDisposable automatycznie.

Podczas programowego dodawania zachowań zachowanie jest dodawane do odpowiedniej Behaviors właściwości ChannelFactory przed utworzeniem dowolnego kanału. Zobacz przykładową sekcję przykładu kodu.

Konstruktory

Właściwości

Metody

Zdarzenia

Jawne implementacje interfejsu

Metody rozszerzania

Dotyczy