ChannelFactory Klas

Definitie

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

Overname

Object

CommunicationObject

ChannelFactory

Afgeleid

System.ServiceModel.ChannelFactory<TChannel>

Implementeringen

IDisposable IChannelFactory ICommunicationObject

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u programmatisch een clientgedrag invoegt voordat het kanaalobject door de fabriek wordt gemaakt.

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

Opmerkingen

Kanaalfactory's die de IChannelFactory interface en de bijbehorende kanalen implementeren, worden doorgaans gebruikt door de initiators van een communicatiepatroon. Listener factory's die de IChannelListener interface en de bijbehorende listeners implementeren, bieden de mechanismen waarmee kanalen worden geaccepteerd voor communicatie.

Deze klasse maakt geen deel uit van het kanaalmodel, maar van het servicemodel. De CreateFactory methode biedt de middelen om een IChannelFactory voor een service-eindpunt te maken. Gebruik deze om een client te maken die is gekoppeld aan een interfacecontract voor de service zonder metagegevens of beleid te gebruiken.

Speciale opmerking voor beheerde C++-gebruikers die zijn afgeleid van deze klasse:

• Plaats de opschooncode in (On)(Begin)Close (en/of OnAbort), niet in een destructor.
• Vermijd destructors; ze zorgen ervoor dat de compiler automatisch genereert IDisposable.
• Vermijd niet-referentieleden; ze kunnen ertoe leiden dat de compiler automatisch genereert IDisposable.
• Vermijd het gebruik van een finalizer; maar als u er een opneemt, moet u de buildwaarschuwing en -aanroep SuppressFinalize(Object) onderdrukken en de finalizer zelf van (On)(Begin)Close (en/of OnAbort) om te emuleren wat het automatisch gegenereerde IDisposable gedrag zou zijn geweest.

Wanneer u gedrag programmatisch toevoegt, wordt het gedrag aan de juiste Behaviors eigenschap toegevoegd voordat ChannelFactory u een kanaal maakt. Zie de voorbeeldsectie voor een codevoorbeeld.