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. 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é
- Implémente
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 à 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 demande.
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) |
Méthodes d’extension
CloseHelperAsync(ICommunicationObject, TimeSpan) |
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. |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
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. |