IInputChannel Interface

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

Source:

IInputChannel.cs

Définit l'interface qu'un canal doit implémenter pour recevoir un message.

public interface class IInputChannel : System::ServiceModel::Channels::IChannel

public interface IInputChannel : System.ServiceModel.Channels.IChannel

type IInputChannel = interface
    interface IChannel
    interface ICommunicationObject

Public Interface IInputChannel
Implements IChannel

Dérivé

System.ServiceModel.Channels.IAsyncInputChannel

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.TransportDuplexSessionChannel

Implémente

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

Le contrat IInputChannel inclut des variantes synchrones et asynchrones de fonctionnalités de réception, de tentative de réception et d'attente de message.

Le modèle d'extraction est utilisé en général avec un IInputChannel pour recevoir des messages : vous appelez Receive (pour « extraire » un message du canal) puis attendez l'arrivée d'un message. Un autre modèle d'utilisation consiste à appeler BeginWaitForMessage(TimeSpan, AsyncCallback, Object) ou BeginWaitForMessage(TimeSpan, AsyncCallback, Object) puis Receive(TimeSpan). Cette approche est commune pour les utilisations transactionnelles où vous démarrez la transaction entre les appels à WaitForMessage(TimeSpan) et Receive.

Un IInputChannel n'est pas lié nécessairement à un expéditeur unique. D'autres canaux et interfaces de canaux peuvent fournir une corrélation entre des expéditeurs particuliers et un IInputChannel, mais le contrat de base ne définit aucune restriction de ce type. Une implémentation peut créer un nouveau IInputChannel pour chaque message ou réutiliser le même IInputChannel pour plusieurs messages ou expéditeurs.

Propriétés

LocalAddress	Obtient l'adresse sur laquelle ce canal d'entrée reçoit des messages.
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)
BeginReceive(AsyncCallback, Object)	Commence une opération asynchrone pour recevoir un message auquel est associé un objet d'état.
BeginReceive(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour recevoir un message auquel sont associés un délai d'attente spécifié et un objet d'état.
BeginTryReceive(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour recevoir un message auquel sont associés un délai d'attente spécifié et un objet d'état.
BeginWaitForMessage(TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone d'attente de message à laquelle sont associés un délai d'attente spécifié et un objet d'état.
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)
EndReceive(IAsyncResult)	Termine une opération asynchrone pour recevoir un message.
EndTryReceive(IAsyncResult, Message)	Termine l'opération asynchrone spécifiée pour recevoir un message.
EndWaitForMessage(IAsyncResult)	Termine l'opération asynchrone spécifiée d'attente d'un message.
GetProperty<T>()	Retourne un objet typé demandé (s'il existe) à partir de la couche appropriée dans la pile de canaux. (Hérité de IChannel)
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)
Receive()	Retourne le message reçu, le cas échéant. Si aucun message n'est disponible, elle reste bloquée pendant un intervalle de temps par défaut.
Receive(TimeSpan)	Retourne le message reçu, le cas échéant. Si aucun message n'est disponible, elle reste bloquée pendant un intervalle de temps spécifié.
TryReceive(TimeSpan, Message)	Tente de recevoir un message dans un intervalle de temps spécifié.
WaitForMessage(TimeSpan)	Retourne une valeur qui indique si un message est arrivé dans un intervalle de temps spécifié.

É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 qu'un canal doit implémenter pour recevoir un message.
OpenHelperAsync(ICommunicationObject, TimeSpan)	Définit l'interface qu'un canal doit implémenter pour recevoir un message.