IInputChannel Interface

Définition

Définit l'interface qu'un canal doit implémenter pour recevoir un message.Defines the interface that a channel must implement to receive a 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

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é.Calling methods from classes that implement this interface with untrusted data is a security risk. Appelez les méthodes de classes qui implémentent cette interface avec des données approuvées uniquement.Call the methods from classes that implement this interface only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

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.The IInputChannel contract includes synchronous and asynchronous variants of receive, try-to-receive and wait-for-a-message functionality.

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.The pull model is used typically with an IInputChannel to receive messages: you call Receive (to "pull" a message out of the channel) and then wait for a message to arrive. Un autre modèle d'utilisation consiste à appeler BeginWaitForMessage(TimeSpan, AsyncCallback, Object) ou BeginWaitForMessage(TimeSpan, AsyncCallback, Object) puis Receive(TimeSpan).An alternative usage pattern is to call BeginWaitForMessage(TimeSpan, AsyncCallback, Object) or BeginWaitForMessage(TimeSpan, AsyncCallback, Object), and then call Receive(TimeSpan). Cette approche est commune pour les utilisations transactionnelles où vous démarrez la transaction entre les appels à WaitForMessage(TimeSpan) et Receive.This approach is common for transactional usages where you start the transaction between the calls to WaitForMessage(TimeSpan) and Receive.

Un IInputChannel n'est pas lié nécessairement à un expéditeur unique.An IInputChannel is not necessarily bound to a single sender. 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.Other channels and channel interfaces can provide a correlation between particular senders and an IInputChannel, but the base contract makes no such restriction. 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.An implementation can create a new IInputChannel for each message or reuse the same IInputChannel for multiple messages and senders.

Propriétés

LocalAddress

Obtient l'adresse sur laquelle ce canal d'entrée reçoit des messages.Gets the address on which the input channel receives messages.

State

Obtient l'état actuel de l'objet orienté communication.Gets the current state of the communication-oriented object.

(Hérité de ICommunicationObject)

Méthodes

Abort()

Provoque la transition immédiate d'un objet de communication de son état actuel à l'état fermé.Causes a communication object to transition immediately from its current state into the closed state.

(Hérité de ICommunicationObject)
BeginClose(AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication.Begins an asynchronous operation to close a communication object.

(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é.Begins an asynchronous operation to close a communication object with a specified timeout.

(Hérité de ICommunicationObject)
BeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.Begins an asynchronous operation to open a communication object.

(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é.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Hérité de ICommunicationObject)
BeginReceive(AsyncCallback, Object)

Commence une opération asynchrone pour recevoir un message auquel est associé un objet d'état.Begins an asynchronous operation to receive a message that has a state object associated with it.

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.Begins an asynchronous operation to receive a message that has a specified time out and state object associated with it.

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.Begins an asynchronous operation to receive a message that has a specified time out and state object associated with it.

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.Begins an asynchronous wait-for-a-message-to-arrive operation that has a specified time out and state object associated with it.

Close()

Provoque la transition d'un objet de communication de son état actuel à l'état fermé.Causes a communication object to transition from its current state into the closed state.

(Hérité de ICommunicationObject)
Close(TimeSpan)

Provoque la transition d'un objet de communication de son état actuel à l'état fermé.Causes a communication object to transition from its current state into the closed state.

(Hérité de ICommunicationObject)
EndClose(IAsyncResult)

Termine une opération asynchrone pour fermer un objet de communication.Completes an asynchronous operation to close a communication object.

(Hérité de ICommunicationObject)
EndOpen(IAsyncResult)

Termine une opération asynchrone pour ouvrir un objet de communication.Completes an asynchronous operation to open a communication object.

(Hérité de ICommunicationObject)
EndReceive(IAsyncResult)

Termine une opération asynchrone pour recevoir un message.Completes an asynchronous operation to receive a message.

EndTryReceive(IAsyncResult, Message)

Termine l'opération asynchrone spécifiée pour recevoir un message.Completes the specified asynchronous operation to receive a message.

EndWaitForMessage(IAsyncResult)

Termine l'opération asynchrone spécifiée d'attente d'un message.Completes the specified asynchronous wait-for-a-message operation.

GetProperty<T>()

Retourne un objet typé demandé (s'il existe) à partir de la couche appropriée dans la pile de canaux.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

(Hérité de IChannel)
Open()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.Causes a communication object to transition from the created state into the opened state.

(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é.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Hérité de ICommunicationObject)
Receive()

Retourne le message reçu, le cas échéant.Returns the message received, if one is available. Si aucun message n'est disponible, elle reste bloquée pendant un intervalle de temps par défaut.If a message is not available, blocks for a default interval of time.

Receive(TimeSpan)

Retourne le message reçu, le cas échéant.Returns the message received, if one is available. Si aucun message n'est disponible, elle reste bloquée pendant un intervalle de temps spécifié.If a message is not available, blocks for a specified interval of time.

TryReceive(TimeSpan, Message)

Tente de recevoir un message dans un intervalle de temps spécifié.Tries to receive a message within a specified interval of time.

WaitForMessage(TimeSpan)

Retourne une valeur qui indique si un message est arrivé dans un intervalle de temps spécifié.Returns a value that indicates whether a message has arrived within a specified interval of time.

Événements

Closed

Se produit lorsque l'objet de communication termine sa transition de l'état de fermeture à l'état fermé.Occurs when the communication object completes its transition from the closing state into the closed state.

(Hérité de ICommunicationObject)
Closing

Se produit lorsque l'objet de communication entre d'abord dans l'état fermeture.Occurs when the communication object first enters the closing state.

(Hérité de ICommunicationObject)
Faulted

Se produit lorsque l'objet de communication entre d'abord dans l'état de faute.Occurs when the communication object first enters the faulted state.

(Hérité de ICommunicationObject)
Opened

Se produit lorsque l'objet de communication termine sa transition de l'état d'ouverture à l'état ouvert.Occurs when the communication object completes its transition from the opening state into the opened state.

(Hérité de ICommunicationObject)
Opening

Se produit lorsque l'objet de communication entre d'abord dans l'état d'ouverture.Occurs when the communication object first enters the opening state.

(Hérité de ICommunicationObject)

S’applique à