Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ChannelFactory classe

 

Date de publication : novembre 2016

Crée et gère les canaux utilisés par les clients pour envoyer des messages aux points de terminaison de service.

Espace de noms:   System.ServiceModel
Assembly:  System.ServiceModel (dans System.ServiceModel.dll)


public abstract class ChannelFactory : CommunicationObject, IChannelFactory, 
	ICommunicationObject, IDisposable

NomDescription
System_CAPS_protmethodChannelFactory()

Initialise une nouvelle instance de la classe ChannelFactory.

NomDescription
System_CAPS_pubpropertyCredentials

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.

System_CAPS_protpropertyDefaultCloseTimeout

Obtient l'intervalle de temps par défaut fourni pour terminer une opération de fermeture.(Remplace CommunicationObject.DefaultCloseTimeout.)

System_CAPS_protpropertyDefaultOpenTimeout

Obtient l'intervalle de temps par défaut fourni pour terminer une opération d'ouverture.(Remplace CommunicationObject.DefaultOpenTimeout.)

System_CAPS_pubpropertyEndpoint

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

System_CAPS_protpropertyIsDisposed

Obtient une valeur qui indique si l'objet de communication a été supprimé.(Hérité de CommunicationObject.)

System_CAPS_pubpropertyState

Obtient une valeur qui indique l'état actuel de l'objet de communication.(Hérité de CommunicationObject.)

System_CAPS_protpropertyThisLock

Obtient le verrou mutuellement exclusif qui protège l'instance de classe pendant une transition d'état.(Hérité de CommunicationObject.)

NomDescription
System_CAPS_pubmethodAbort()

Provoque la transition immédiate d'un objet de communication de son état actuel à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_protmethodApplyConfiguration(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.

System_CAPS_pubmethodBeginClose(AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication.(Hérité de CommunicationObject.)

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

System_CAPS_pubmethodBeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.(Hérité de CommunicationObject.)

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

System_CAPS_pubmethodClose()

Provoque la transition d'un objet de communication de son état actuel à l'état fermé.(Hérité de CommunicationObject.)

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

System_CAPS_protmethodCreateDescription()

En cas d'implémentation dans une classe dérivée, crée une description du point de terminaison du service associée à la fabrique de canal.

System_CAPS_protmethodCreateFactory()

Génère la fabrique de canal pour le point de terminaison actif de la fabrique.

System_CAPS_pubmethodEndClose(IAsyncResult)

Termine une opération asynchrone pour fermer un objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodEndOpen(IAsyncResult)

Termine une opération asynchrone pour ouvrir un objet de communication.(Hérité de CommunicationObject.)

System_CAPS_protmethodEnsureOpened()

Ouvre la fabrique de canal active si elle n'est pas encore ouverte.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFault()

Provoque la transition d'un objet de communication de son état actuel à l'état d'erreur.(Hérité de CommunicationObject.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_protmethodGetCommunicationObjectType()

Obtient le type d'objet de communication.(Hérité de CommunicationObject.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetProperty<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.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodInitializeEndpoint(Binding, EndpointAddress)

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

System_CAPS_protmethodInitializeEndpoint(ServiceEndpoint)

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

System_CAPS_protmethodInitializeEndpoint(String, EndpointAddress)

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

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnAbort()

Ferme la fabrication de canal interne de la fabrication de canal active.(Remplace CommunicationObject.OnAbort().)

System_CAPS_protmethodOnBeginClose(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.(Remplace CommunicationObject.OnBeginClose(TimeSpan, AsyncCallback, Object).)

System_CAPS_protmethodOnBeginOpen(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.(Remplace CommunicationObject.OnBeginOpen(TimeSpan, AsyncCallback, Object).)

System_CAPS_protmethodOnClose(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.(Remplace CommunicationObject.OnClose(TimeSpan).)

System_CAPS_protmethodOnClosed()

Appelé pendant la transition d'un objet de communication à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_protmethodOnClosing()

Appelé pendant la transition d'un objet de communication à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_protmethodOnEndClose(IAsyncResult)

Clôture une opération de fermeture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle.(Remplace CommunicationObject.OnEndClose(IAsyncResult).)

System_CAPS_protmethodOnEndOpen(IAsyncResult)

Clôture une opération d'ouverture asynchrone sur la fabrique de canal interne de la fabrique de canal actuelle.(Remplace CommunicationObject.OnEndOpen(IAsyncResult).)

System_CAPS_protmethodOnFaulted()

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

System_CAPS_protmethodOnOpen(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.(Remplace CommunicationObject.OnOpen(TimeSpan).)

System_CAPS_protmethodOnOpened()

Initialise une copie en lecture seule de l'objet ClientCredentials pour la fabrique de canal.(Remplace CommunicationObject.OnOpened().)

System_CAPS_protmethodOnOpening()

Génère la fabrication de canal interne pour le canal actif.(Remplace CommunicationObject.OnOpening().)

System_CAPS_pubmethodOpen()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.(Hérité de CommunicationObject.)

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

System_CAPS_protmethodThrowIfDisposed()

Renvoie une exception si l'objet de communication est supprimé.(Hérité de CommunicationObject.)

System_CAPS_protmethodThrowIfDisposedOrImmutable()

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

System_CAPS_protmethodThrowIfDisposedOrNotOpen()

Renvoie une exception si l'objet de communication n'est pas dans l'état Opened.(Hérité de CommunicationObject.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubeventClosed

Se produit lorsqu'un objet de communication passe à l'état fermé.(Hérité de CommunicationObject.)

System_CAPS_pubeventClosing

Se produit lorsqu'un objet de communication passe à l'état de fermeture.(Hérité de CommunicationObject.)

System_CAPS_pubeventFaulted

Se produit lorsqu'un objet de communication passe à l'état d'erreur.(Hérité de CommunicationObject.)

System_CAPS_pubeventOpened

Se produit lorsqu'un objet de communication passe à l'état ouvert.(Hérité de CommunicationObject.)

System_CAPS_pubeventOpening

Se produit lorsqu'un objet de communication passe à l'état d'ouverture.(Hérité de CommunicationObject.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDisposable.Dispose()

Ferme la fabrication de canal active.

Channel factories that implement the T:System.ServiceModel.Channels.IChannelFactory interface and their associated channels are generally used by the initiators of a communication pattern. Listener factories that implement the T:System.ServiceModel.Channels.IChannelListener interface and their associated listeners provide the mechanisms with which channels are accepted for communications.

This class is not part of the channel model, but of the service model. The M:System.ServiceModel.ChannelFactory.CreateFactory method provides the means to create an T:System.ServiceModel.Channels.IChannelFactory for a service endpoint. Use it to construct a client that hooks up to an interface contract on the service without using metadata or policy.

System_CAPS_noteRemarque

Setting ChannelFactory.Credentials.Windows.AllowedImpersonationLevel to TokenImpersonationLevel.Anonymous always results in an anonymous logon regardless of impersonation level.

Special note for Managed C++ users deriving from this class:

  • Put your cleanup code in (On)(Begin)Close (and/or OnAbort), not in a destructor.

  • Avoid destructors; they cause the compiler to auto-generate T:System.IDisposable.

  • Avoid non-reference members; they can cause the compiler to auto-generate T:System.IDisposable.

  • Avoid using a finalizer; but if you include one, you should suppress the build warning and call M:System.GC.SuppressFinalize(System.Object) and the finalizer itself from (On)(Begin)Close (and/or OnAbort) to emulate what would have been the auto-generated T:System.IDisposable behavior.

When adding behaviors programmatically, the behavior is added to the appropriate Behaviors property on the T:System.ServiceModel.ChannelFactory prior to the creation of any channel. See the example section for a code sample.

The following code example shows how to insert programmatically a client behavior prior to the creation of the channel object by the factory.

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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 3.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: