IChannel Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit l’interface de base que tous les objets de canal doivent implémenter. Elle exige qu’elle implémente l’interface de machine d’état partagée par tous les objets de communication et qu’elle implémente une méthode pour récupérer des objets à partir de la pile de canaux.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Dérivé
- Implémente
Remarques
Important
L’appel de méthodes à partir de classes qui implémentent cette interface avec des données non approuvées est un risque de sécurité. Appelez les méthodes des classes qui implémentent cette interface uniquement avec des données approuvées. Pour plus d’informations, consultez Valider toutes les entrées.
Les canaux doivent satisfaire le contrat d’un ordinateur d’état tel que défini par l’interface ICommunicationObject .
L’interface IChannel ajoute la
GetProperty méthode à l’interface ICommunicationObject . Cette méthode fournit un mécanisme permettant de récupérer des propriétés à partir de la pile de canaux, quel que soit l’emplacement dans la pile où ces propriétés sont actives. Le terme « propriété » dans le nom de la méthode fait référence à une information qui appartient à l’un des canaux de la pile. Le type CLR de 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 des messages.
IOutputChannel pour l’envoi de messages.
IRequestChannel pour l’envoi d’une demande.
IReplyChannel pour envoyer une réponse.
IDuplexChannel pour la messagerie bidirectionnelle.
Propriétés
| Nom | Description |
|---|---|
| State |
Obtient l’état actuel de l’objet orienté communication. (Hérité de ICommunicationObject) |
Méthodes
| Nom | Description |
|---|---|
| Abort() |
Provoque la transition immédiate d’un objet de communication de son état actuel vers 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’expiration 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 vers l’état fermé. (Hérité de ICommunicationObject) |
| Close(TimeSpan) |
Provoque la transition d’un objet de communication de son état actuel vers 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é, le cas échéant, à partir de la couche appropriée dans la pile de canaux. |
| Open() |
Provoque la transition d’un objet de communication entre l’état créé et l’état ouvert. (Hérité de ICommunicationObject) |
| 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 ICommunicationObject) |
Événements
| Nom | Description |
|---|---|
| Closed |
Se produit lorsque l’objet de communication termine sa transition de l’état fermant vers l’état fermé. (Hérité de ICommunicationObject) |
| Closing |
Se produit lorsque l’objet de communication entre d’abord dans l’état de fermeture. (Hérité de ICommunicationObject) |
| Faulted |
Se produit lorsque l’objet de communication entre d’abord dans l’état d’erreur. (Hérité de ICommunicationObject) |
| Opened |
Se produit lorsque l’objet de communication termine sa transition de l’état ouvrant à 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) |
