IChannel Interface

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Définit l'interface de base que tous les objets de canal doivent implémenter. Cela requiert l'implémentation de l'interface d'ordinateur d'état partagée par tous les objets de communication et l'implémentation d'une méthode pour récupérer des objets de la pile de canaux.

public interface class IChannel : System::ServiceModel::ICommunicationObject

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Dérivé

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Implémente

ICommunicationObject

Remarques

Important

L’appel de méthodes de classes qui implémentent cette interface avec des données non approuvées est un risque de sécurité. Appelez les méthodes de classes qui implémentent cette interface avec des données approuvées uniquement. Pour plus d’informations, consultez Valider toutes les entrées.

Les canaux doivent être conformes au contrat d'un ordinateur d'état défini par l'interface ICommunicationObject.

L'interface IChannel ajoute la

GetProperty méthode de l’interface ICommunicationObject . Cette méthode fournit un mécanisme pour récupérer des propriétés de la pile de canaux quel que soit l'emplacement des propriétés dans la pile. Le terme "propriété" dans le nom de méthode fait référence à une information qui appartient à l'un des canaux dans la pile. Le type CLR pour cette propriété est déterminé par T. Cette méthode de récupération est également utilisée sur les fabriques de canaux et les écouteurs de canal.

IChannel est hérité par chacune des interfaces de canal associées aux modèles d’échange de messages de base :

• IInputChannel pour recevoir les messages.

• IOutputChannel pour l’envoi de messages.

• IRequestChannel pour l’envoi d’une requête.

• IReplyChannel pour envoyer une réponse.

• IDuplexChannel pour la messagerie bidirectionnelle.

Propriétés

State

Obtient l'état actuel de l'objet orienté communication. (Hérité de ICommunicationObject)

Méthodes

Abort()	Provoque la transition immédiate d'un objet de communication de son état actuel à l'état fermé. (Hérité de ICommunicationObject)
BeginClose(AsyncCallback, Object)	Commence une opération asynchrone pour fermer un objet de communication. (Hérité de ICommunicationObject)
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 ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Commence une opération asynchrone pour ouvrir un objet de communication. (Hérité de ICommunicationObject)
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 ICommunicationObject)
Close()	Provoque la transition d'un objet de communication de son état actuel à l'état fermé. (Hérité de ICommunicationObject)
Close(TimeSpan)	Provoque la transition d'un objet de communication de son état actuel à l'état fermé. (Hérité de ICommunicationObject)
EndClose(IAsyncResult)	Termine une opération asynchrone pour fermer un objet de communication. (Hérité de ICommunicationObject)
EndOpen(IAsyncResult)	Termine une opération asynchrone pour ouvrir un objet de communication. (Hérité de ICommunicationObject)
GetProperty<T>()	Retourne un objet typé demandé (s'il existe) à partir de la couche appropriée dans la pile de canaux.
Open()	Provoque la transition d'un objet de communication de l'état créé à l'état ouvert. (Hérité de ICommunicationObject)
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 ICommunicationObject)

Événements

Closed	Se produit lorsque l'objet de communication termine sa transition de l'état de fermeture à l'état fermé. (Hérité de ICommunicationObject)
Closing	Se produit lorsque l'objet de communication entre d'abord dans l'état fermeture. (Hérité de ICommunicationObject)
Faulted	Se produit lorsque l'objet de communication entre d'abord dans l'état de faute. (Hérité de ICommunicationObject)
Opened	Se produit lorsque l'objet de communication termine sa transition de l'état d'ouverture à l'état ouvert. (Hérité de ICommunicationObject)
Opening	Se produit lorsque l'objet de communication entre d'abord dans l'état d'ouverture. (Hérité de ICommunicationObject)