ChannelFactory Klass

Definition

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

public abstract class ChannelFactory : System.ServiceModel.Channels.CommunicationObject, 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

Public MustInherit Class ChannelFactory
Inherits CommunicationObject
Implements IChannelFactory, IDisposable

Arv

Object

CommunicationObject

ChannelFactory

Härledda

System.ServiceModel.ChannelFactory<TChannel>

Implementeringar

IDisposable IChannelFactory ICommunicationObject

Exempel

I följande kodexempel visas hur du infogar programmatiskt ett klientbeteende innan du skapar kanalobjektet av fabriken.

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

Kommentarer

Kanalfabriker som implementerar IChannelFactory gränssnittet och deras associerade kanaler används vanligtvis av initierarna för ett kommunikationsmönster. Lyssnarfabriker som implementerar IChannelListener gränssnittet och deras associerade lyssnare tillhandahåller de mekanismer med vilka kanaler accepteras för kommunikation.

Den här klassen är inte en del av kanalmodellen, utan i tjänstmodellen. Metoden CreateFactory ger möjlighet att skapa en IChannelFactory för en tjänstslutpunkt. Använd den för att konstruera en klient som ansluter till ett gränssnittskontrakt för tjänsten utan att använda metadata eller princip.

Särskild anmärkning för hanterade C++-användare som härleds från den här klassen:

• Placera din rensningskod i (På)(Begin)Close (och/eller OnAbort), inte i en destruktor.
• Undvik destructors; de gör att kompilatorn automatiskt genererar IDisposable.
• Undvik icke-referensmedlemmar; de kan göra så att kompilatorn automatiskt genererar IDisposable.
• Undvik att använda en finalizer; men om du inkluderar en bör du ignorera byggvarningen och anropet SuppressFinalize(Object) och själva slutföraren från (På)(Begin)Close (och/eller OnAbort) för att emulera vad som skulle ha varit det automatiskt genererade beteendet IDisposable .

När du lägger till beteenden programmatiskt läggs beteendet till i lämplig Behaviors egenskap ChannelFactory innan någon kanal skapas. Se exempelavsnittet för ett kodexempel.