ChannelFactory<TChannel> Classe

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

Source:

ChannelFactory.cs

Fabrique qui crée des canaux de différents types utilisés par les clients pour envoyer des messages à différents points de terminaison de service configurés.

generic <typename TChannel>
public ref class ChannelFactory : System::ServiceModel::ChannelFactory, System::ServiceModel::Channels::IChannelFactory<TChannel>

public class ChannelFactory<TChannel> : System.ServiceModel.ChannelFactory, System.ServiceModel.Channels.IChannelFactory<TChannel>

type ChannelFactory<'Channel> = class
    inherit ChannelFactory
    interface IChannelFactory
    interface ICommunicationObject
    interface IChannelFactory<'Channel>

Public Class ChannelFactory(Of TChannel)
Inherits ChannelFactory
Implements IChannelFactory(Of TChannel)

Paramètres de type

TChannel

Type de canal produit par la fabrique de canaux. Ce type doit être IOutputChannel ou IRequestChannel.

Héritage

Object

CommunicationObject

ChannelFactory

ChannelFactory<TChannel>

Dérivé

System.ServiceModel.Configuration.ConfigurationChannelFactory<TChannel>

System.ServiceModel.DuplexChannelFactory<TChannel>

System.ServiceModel.Federation.WSTrustChannelFactory

System.ServiceModel.Security.WSTrustChannelFactory

System.ServiceModel.Web.WebChannelFactory<TChannel>

Implémente

IChannelFactory IChannelFactory<TChannel> ICommunicationObject

Exemples

L’exemple suivant montre comment créer une fabrique de canaux et l’utiliser pour créer et gérer des canaux.

    BasicHttpBinding binding = new BasicHttpBinding();
    EndpointAddress address = new EndpointAddress("http://localhost:8000/ChannelApp");

    ChannelFactory<IRequestChannel> factory =
        new ChannelFactory<IRequestChannel>(binding, address);

    IRequestChannel channel = factory.CreateChannel();
    channel.Open();
    Message request = Message.CreateMessage(MessageVersion.Soap11, "hello");
    Message reply = channel.Request(request);
    Console.Out.WriteLine(reply.Headers.Action);
    reply.Close();
    channel.Close();
    factory.Close();
}

L’exemple de code suivant montre comment insérer par programme un comportement client avant la création de l’objet de canal par la fabrique.

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

Remarques

Cette classe générique permet des scénarios plus avancés où il est nécessaire de créer une fabrique de canaux qui peut être utilisée pour créer plusieurs types de canal.

Lors de l’ajout de comportements par programmation, le comportement est ajouté à la propriété Behaviors appropriée sur le ChannelFactory avant la création d’un canal. Consultez l’exemple de section d’un exemple de code.

Les applications clientes ou appelantes fréquemment (par exemple, les applications de niveau intermédiaire sont également des applications clientes) utilisant ce type ont également des besoins de gestion d’état complexes ainsi que des besoins en matière de performances. Pour plus d’informations sur ces scénarios, consultez Middle-Tier applications clientes.

Constructeurs

ChannelFactory<TChannel>(Binding)	Initialise une nouvelle instance de la classe ChannelFactory<TChannel>.
ChannelFactory<TChannel>(Binding, EndpointAddress)	Initialise une nouvelle instance de la classe ChannelFactory<TChannel> avec une liaison et une adresse de point de terminaison spécifiées.
ChannelFactory<TChannel>(ServiceEndpoint)	Initialise une nouvelle instance de la classe ChannelFactory<TChannel> qui produit des canaux avec un point de terminaison spécifié.
ChannelFactory<TChannel>(Type)	Initialise une nouvelle instance de la classe ChannelFactory<TChannel>.

Propriétés

Credentials	Obtient les informations d’identification utilisées par les clients pour communiquer un point de terminaison de service sur les canaux produits par la fabrique. (Hérité de ChannelFactory)
DefaultCloseTimeout	Obtient l’intervalle de temps par défaut fourni pour qu’une opération de fermeture se termine. (Hérité de ChannelFactory)
DefaultOpenTimeout	Obtient l’intervalle de temps par défaut fourni pour qu’une opération ouverte se termine. (Hérité de ChannelFactory)
Endpoint	Obtient le point de terminaison de service auquel les canaux générés par la connexion d’usine. (Hérité de ChannelFactory)
IsDisposed	Obtient une valeur qui indique si l’objet de communication a été supprimé. (Hérité de CommunicationObject)
State	Obtient une valeur qui indique l’état actuel de l’objet de communication. (Hérité de CommunicationObject)
ThisLock	Obtient le verrou mutuellement exclusif qui protège l’instance de classe pendant une transition d’état. (Hérité de CommunicationObject)

Méthodes

Abort()	Provoque la transition immédiate d’un objet de communication de son état actuel vers l’état fermant. (Hérité de CommunicationObject)
ApplyConfiguration(String)	Initialise la fabrique de canaux avec les comportements fournis par un fichier de configuration spécifié et avec ceux du point de terminaison de service de la fabrique de canaux. (Hérité de ChannelFactory)
BeginClose(AsyncCallback, Object)	Commence une opération asynchrone pour fermer un objet de communication. (Hérité de CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour fermer un objet de communication avec un délai d’expiration spécifié. (Hérité de CommunicationObject)
BeginOpen(AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir un objet de communication. (Hérité de CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié. (Hérité de CommunicationObject)
Close()	Provoque la transition d’un objet de communication de son état actuel vers l’état fermé. (Hérité de CommunicationObject)
Close(TimeSpan)	Provoque la transition d’un objet de communication de son état actuel vers l’état fermé dans un intervalle de temps spécifié. (Hérité de CommunicationObject)
CreateChannel()	Crée un canal d’un type spécifié vers une adresse de point de terminaison spécifiée.
CreateChannel(EndpointAddress)	Crée un canal utilisé pour envoyer des messages à un service à une adresse de point de terminaison spécifique.
CreateChannel(EndpointAddress, Uri)	Crée un canal utilisé pour envoyer des messages à un service à une adresse de point de terminaison spécifique via une adresse de transport spécifiée.
CreateDescription()	Crée une description du point de terminaison de service.
CreateFactory()	Génère la fabrique de canaux pour le point de terminaison actuel de la fabrique. (Hérité de ChannelFactory)
EndClose(IAsyncResult)	Termine une opération asynchrone pour fermer un objet de communication. (Hérité de CommunicationObject)
EndOpen(IAsyncResult)	Termine une opération asynchrone pour ouvrir un objet de communication. (Hérité de CommunicationObject)
EnsureOpened()	Ouvre la fabrique de canal actuelle si elle n’est pas encore ouverte. (Hérité de ChannelFactory)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Fault()	Provoque la transition d’un objet de communication de son état actuel vers l’état défectueux. (Hérité de CommunicationObject)
GetCommunicationObjectType()	Obtient le type d’objet de communication. (Hérité de CommunicationObject)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>()	Retourne l’objet typé demandé, le cas échéant, à partir de la couche appropriée dans la pile de canaux, ou null s’il n’est pas présent. (Hérité de ChannelFactory)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeEndpoint(Binding, EndpointAddress)	Initialise le point de terminaison de service de la fabrique de canaux avec une liaison et une adresse spécifiées. (Hérité de ChannelFactory)
InitializeEndpoint(ServiceEndpoint)	Initialise le point de terminaison de service de la fabrique de canaux avec un point de terminaison spécifié. (Hérité de ChannelFactory)
InitializeEndpoint(String, EndpointAddress)	Initialise le point de terminaison de service de la fabrique de canaux avec une adresse et une configuration spécifiées. (Hérité de ChannelFactory)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnAbort()	Termine la fabrique de canal interne de la fabrique de canal actuelle. (Hérité de ChannelFactory)
OnBeginClose(TimeSpan, AsyncCallback, Object)	Commence une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle qui a un objet d’état associé à celui-ci. (Hérité de ChannelFactory)
OnBeginOpen(TimeSpan, AsyncCallback, Object)	Commence une opération d’ouverture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle qui a un objet d’état associé à celui-ci. (Hérité de ChannelFactory)
OnClose(TimeSpan)	Les appels se ferment sur la fabrique de canal interne avec un délai d’attente spécifié pour l’achèvement de l’opération. (Hérité de ChannelFactory)
OnClosed()	Appelé pendant la transition d’un objet de communication dans l’état fermant. (Hérité de CommunicationObject)
OnClosing()	Appelé pendant la transition d’un objet de communication dans l’état fermant. (Hérité de CommunicationObject)
OnEndClose(IAsyncResult)	Termine une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle. (Hérité de ChannelFactory)
OnEndOpen(IAsyncResult)	Termine une opération d’ouverture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle. (Hérité de ChannelFactory)
OnFaulted()	Insère le traitement sur un objet de communication après qu’il passe à l’état défectueux en raison de l’appel d’une opération d’erreur synchrone. (Hérité de CommunicationObject)
OnOpen(TimeSpan)	Les appels s’ouvrent sur la fabrique de canal interne de la fabrique de canal actuelle avec un délai d’attente spécifié pour l’achèvement de l’opération. (Hérité de ChannelFactory)
OnOpened()	Initialise une copie en lecture seule de l’objet ClientCredentials pour la fabrique de canaux. (Hérité de ChannelFactory)
OnOpening()	Génère la fabrique de canal interne pour le canal actuel. (Hérité de ChannelFactory)
Open()	Provoque la transition d’un objet de communication entre l’état créé et l’état ouvert. (Hérité de CommunicationObject)
Open(TimeSpan)	Provoque la transition d’un objet de communication entre l’état créé et l’état ouvert dans un intervalle de temps spécifié. (Hérité de CommunicationObject)
ThrowIfDisposed()	Lève une exception si l’objet de communication est supprimé. (Hérité de CommunicationObject)
ThrowIfDisposedOrImmutable()	Lève une exception si l’objet de communication de la propriété State n’est pas défini sur l’état Created. (Hérité de CommunicationObject)
ThrowIfDisposedOrNotOpen()	Lève une exception si l’objet de communication n’est pas dans l’état Opened. (Hérité de CommunicationObject)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Événements

Closed	Se produit lorsqu’un objet de communication passe à l’état fermé. (Hérité de CommunicationObject)
Closing	Se produit lorsqu’un objet de communication passe à l’état fermant. (Hérité de CommunicationObject)
Faulted	Se produit lorsqu’un objet de communication passe à l’état défectueux. (Hérité de CommunicationObject)
Opened	Se produit lorsqu’un objet de communication passe à l’état ouvert. (Hérité de CommunicationObject)
Opening	Se produit lorsqu’un objet de communication passe à l’état d’ouverture. (Hérité de CommunicationObject)

Implémentations d’interfaces explicites

IAsyncDisposable.DisposeAsync()	Fabrique qui crée des canaux de différents types utilisés par les clients pour envoyer des messages à différents points de terminaison de service configurés. (Hérité de ChannelFactory)
IDisposable.Dispose()	Ferme la fabrique de canal actuelle. (Hérité de ChannelFactory)

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

Configure la façon dont les attentes sur les tâches retournées à partir d’un jetable asynchrone sont effectuées.

Cohérence de thread

Ce type est thread safe.