IInputChannel Interface

Définition

Espace de noms:
System.ServiceModel.Channels
Assemblys:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll
Paquet:
System.ServiceModel.Primitives v10.0.652802
Source:
IInputChannel.cs
Source:
IInputChannel.cs
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é
Implémente
IChannel ICommunicationObject

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.

Le IInputChannel contrat inclut des variantes synchrones et asynchrones de réception, de tentative de réception et d’attente pour un message.

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

Un IInputChannel expéditeur n’est pas nécessairement lié à un seul expéditeur. D’autres canaux et interfaces de canal peuvent fournir une corrélation entre des expéditeurs particuliers et un IInputChannel, mais le contrat de base ne fait aucune restriction de ce type. Une implémentation peut créer une nouvelle IInputChannel pour chaque message ou la réutiliser IInputChannel pour plusieurs messages et expéditeurs.

Propriétés

Nom Description
LocalAddress

Obtient l’adresse sur laquelle le canal d’entrée reçoit des messages.
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)
BeginReceive(AsyncCallback, Object)

Commence une opération asynchrone pour recevoir un message qui a un objet d’état associé à celui-ci.
BeginReceive(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour recevoir un message qui a un délai d’expiration et un objet d’état spécifiés qui lui sont associés.
BeginTryReceive(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour recevoir un message qui a un délai d’expiration et un objet d’état spécifiés qui lui sont associés.
BeginWaitForMessage(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone wait-for-a-message-to-arrive qui a un délai d’expiration et un objet d’état spécifiés qui lui sont associés.
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)
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 wait-for-a-message spécifiée.
GetProperty<T>()

Retourne un objet typé demandé, le cas échéant, à partir de la couche appropriée dans la pile de canaux.

(Hérité de IChannel)
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)
Receive()

Retourne le message reçu, le cas échéant. Si un message n’est pas disponible, bloque un intervalle de temps par défaut.
Receive(TimeSpan)

Retourne le message reçu, le cas échéant. Si un message n’est pas disponible, bloque 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

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)

S’applique à