ChannelFactory Třída

Definice

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 IDisposable
    interface IChannelFactory
    interface ICommunicationObject
    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

Dědičnost

Object

CommunicationObject

ChannelFactory

Odvozené

System.ServiceModel.ChannelFactory<TChannel>

Implementuje

IDisposable IChannelFactory ICommunicationObject IAsyncDisposable

Příklady

Následující příklad kódu ukazuje, jak vložit programově chování klienta před vytvořením objektu kanálu objektu továrny.

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

Poznámky

Objekty pro vytváření kanálů, které implementují rozhraní IChannelFactory a jejich přidružené kanály, jsou obecně používány iniciátory komunikačního modelu. Továrny naslouchacího procesu, které implementují rozhraní IChannelListener a jejich přidružené naslouchací procesy, poskytují mechanismy, se kterými kanály jsou přijímány pro komunikaci.

Tato třída není součástí modelu kanálu, ale modelu služby. Metoda CreateFactory poskytuje prostředky k vytvoření IChannelFactory pro koncový bod služby. Slouží k vytvoření klienta, který se připojí ke kontraktu rozhraní ve službě bez použití metadat nebo zásad.

Zvláštní poznámka pro spravované uživatele C++, kteří pocházejí z této třídy:

• Vložte kód čištění do (On)(Begin)Close (a/nebo OnAbort), ne do destruktoru.

• Vyhněte se destruktorům; způsobí, že kompilátor automaticky vygeneruje IDisposable.

• Vyhněte se nenákazovým členům; mohou způsobit, že kompilátor automaticky vygeneruje IDisposable.

• Vyhněte se použití finalizátoru; ale pokud ho zahrnete, měli byste potlačit upozornění sestavení a volat SuppressFinalize(Object) a finalizátor samotný z (On)(Begin)Close (a/nebo OnAbort) emulovat, co by bylo automaticky generované IDisposable chování.

Při programovém přidávání chování se toto chování přidá do příslušné vlastnosti Behaviors na ChannelFactory před vytvořením libovolného kanálu. Ukázku kódu najdete v ukázkové části s ukázkovým kódem.

Konstruktory

Vlastnosti

Metody

Událost

Explicitní implementace rozhraní

Metody rozšíření

Platí pro