ChannelFactory<TChannel> Classe

Définition

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

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>
type ChannelFactory<'Channel> = class
    inherit ChannelFactory
    interface IChannelFactory<'Channel>
    interface IChannelFactory
    interface ICommunicationObject
Public Class ChannelFactory(Of TChannel)
Inherits ChannelFactory
Implements IChannelFactory(Of TChannel)

Paramètres de type

TChannel

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

Héritage
ChannelFactory<TChannel>
Dérivé
Implémente

Exemples

L'exemple suivant montre comment créer une fabrication de canal 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 active plus de scénarios avancés là où la création d’une fabrique de canal qui peut être utilisée pour créer plusieurs types de canaux est nécessaire.

Lors de l'ajout de comportements par programme, le comportement est ajouté à la propriété Behaviors appropriée sur le ChannelFactory avant la création de tout canal. Pour obtenir un exemple de code, consultez la section Exemple.

Souvent, les applications clientes ou appelantes (par exemple, les applications de couche intermédiaire sont également des applications clientes) qui utilisent ce type ont également des besoins en gestion des états et des performances complexes. Pour plus d’informations sur ces scénarios, consultez Applications clientes de niveau intermédiaire.

Constructeurs

ChannelFactory<TChannel>()

Initialise une nouvelle instance de la classe ChannelFactory<TChannel>.

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és.

ChannelFactory<TChannel>(Binding, String)

Initialise une nouvelle instance de la classe ChannelFactory<TChannel> avec une liaison et une adresse distante spécifiés.

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>(String)

Initialise une nouvelle instance de la classe ChannelFactory<TChannel> avec un nom de configuration de point de terminaison spécifié.

ChannelFactory<TChannel>(String, EndpointAddress)

Initialise une nouvelle instance de la classe ChannelFactory<TChannel> associée à un nom spécifié pour la configuration de point de terminaison et l'adresse distante.

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 générés par la fabrique.

(Hérité de ChannelFactory)
DefaultCloseTimeout

Obtient l'intervalle de temps par défaut fourni pour terminer une opération de fermeture.

(Hérité de ChannelFactory)
DefaultOpenTimeout

Obtient l'intervalle de temps par défaut fourni pour terminer une opération d'ouverture.

(Hérité de ChannelFactory)
Endpoint

Obtient le point de terminaison du service auquel se connectent les canaux générés par la fabrique.

(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 à l'état de fermeture.

(Hérité de CommunicationObject)
ApplyConfiguration(String)

Initialise la fabrique de canal avec les comportements fournis par un fichier de configuration spécifié et avec ceux définis dans le point de terminaison du service de la fabrique de canal.

(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'attente 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 à l'état fermé.

(Hérité de CommunicationObject)
Close(TimeSpan)

Provoque la transition d'un objet de communication de son état actuel à l'état fermé dans un intervalle de temps spécifié.

(Hérité de CommunicationObject)
CreateChannel()

Crée un canal d'un type spécifié à une adresse de point de terminaison spécifiée.

CreateChannel(Binding, EndpointAddress)

Crée un canal d’un type spécifié utilisé pour envoyer des messages à un point de terminaison de service configuré avec une liaison spécifiée.

CreateChannel(Binding, EndpointAddress, Uri)

Crée un canal d’un type spécifié utilisé pour envoyer des messages à un point de terminaison de service à une adresse de transport spécifiée configurée avec une liaison 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.

CreateChannel(String)

Crée un canal utilisé pour envoyer des messages à un service dont le point de terminaison est configuré de façon spécifiée.

CreateChannelWithActAsToken(SecurityToken)

Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité.

CreateChannelWithActAsToken(SecurityToken, EndpointAddress)

Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité à une adresse de point de terminaison spécifique.

CreateChannelWithActAsToken(SecurityToken, EndpointAddress, Uri)

Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité à une adresse de point de terminaison spécifique via une adresse de transport spécifiée.

CreateChannelWithIssuedToken(SecurityToken)

Crée un canal utilisé pour envoyer des messages à un service agissant comme un jeton de sécurité émis.

CreateChannelWithIssuedToken(SecurityToken, EndpointAddress)

Crée un canal utilisé pour envoyer des messages à un service avec un jeton de sécurité émis à une adresse de point de terminaison spécifique.

CreateChannelWithIssuedToken(SecurityToken, EndpointAddress, Uri)

Crée un canal utilisé pour envoyer des messages à un service avec un jeton de sécurité émis à une adresse de point de terminaison spécifique via une adresse de transport spécifiée.

CreateChannelWithOnBehalfOfToken(SecurityToken)

Crée un canal utilisé pour envoyer des messages à un service agissant pour le compte d'un jeton de sécurité.

CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress)

Crée un canal utilisé pour envoyer des messages à un service agissant pour le compte d'un jeton de sécurité à une adresse de point de terminaison spécifique.

CreateChannelWithOnBehalfOfToken(SecurityToken, EndpointAddress, Uri)

Crée un canal utilisé pour envoyer des messages à un service agissant pour le compte du jeton de sécurité à 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 canal pour le point de terminaison actif 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 active 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 à l'état d'erreur.

(Hérité de CommunicationObject)
GetCommunicationObjectType()

Obtient le type d'objet de communication.

(Hérité de CommunicationObject)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetProperty<T>()

Retourne l'objet typé demandé (s'il existe) depuis la couche appropriée de la pile des canaux, ou la valeur null si l'objet est absent.

(Hérité de ChannelFactory)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeEndpoint(Binding, EndpointAddress)

Initialise le point de terminaison du service de la fabrique de canal avec une liaison et une adresse spécifiées.

(Hérité de ChannelFactory)
InitializeEndpoint(ServiceEndpoint)

Initialise le point de terminaison du service de la fabrication de canal avec un point de terminaison spécifié.

(Hérité de ChannelFactory)
InitializeEndpoint(String, EndpointAddress)

Initialise le point de terminaison du service de la fabrique de canal avec une adresse et une configuration spécifiées.

(Hérité de ChannelFactory)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnAbort()

Ferme la fabrication de canal interne de la fabrication de canal active.

(Hérité de ChannelFactory)
OnBeginClose(TimeSpan, AsyncCallback, Object)

Amorce une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique active à laquelle est associé un objet d'état.

(Hérité de ChannelFactory)
OnBeginOpen(TimeSpan, AsyncCallback, Object)

Amorce une opération d'ouverture asynchrone sur la fabrique de canal interne de la fabrique active à laquelle est associé un objet d'état.

(Hérité de ChannelFactory)
OnClose(TimeSpan)

Appelle la fermeture 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 à l'état de fermeture.

(Hérité de CommunicationObject)
OnClosing()

Appelé pendant la transition d'un objet de communication à l'état de fermeture.

(Hérité de CommunicationObject)
OnEndClose(IAsyncResult)

Clôture une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle.

(Hérité de ChannelFactory)
OnEndOpen(IAsyncResult)

Clôture 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 sa transition vers l’état d’erreur en raison de l’appel d’une opération d’erreur synchrone.

(Hérité de CommunicationObject)
OnOpen(TimeSpan)

Appelle l'ouverture sur la fabrique de canal interne de la fabrique active 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 canal.

(Hérité de ChannelFactory)
OnOpening()

Génère la fabrication de canal interne pour le canal actif.

(Hérité de ChannelFactory)
Open()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.

(Hérité de CommunicationObject)
Open(TimeSpan)

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié.

(Hérité de CommunicationObject)
ThrowIfDisposed()

Renvoie une exception si l'objet de communication est supprimé.

(Hérité de CommunicationObject)
ThrowIfDisposedOrImmutable()

Renvoie une exception si la propriété State de l'objet de communication n'a pas pour valeur l'état Created.

(Hérité de CommunicationObject)
ThrowIfDisposedOrNotOpen()

Renvoie 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 de fermeture.

(Hérité de CommunicationObject)
Faulted

Se produit lorsqu'un objet de communication passe à l'état d'erreur.

(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()

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

(Hérité de ChannelFactory)
IDisposable.Dispose()

Ferme la fabrication de canal active.

(Hérité de ChannelFactory)

S’applique à

Cohérence de thread

Ce type est thread-safe.