IInputChannel 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 qu'un canal doit implémenter pour recevoir un message.
public interface class IInputChannel : System::ServiceModel::Channels::IChannelpublic interface IInputChannel : System.ServiceModel.Channels.IChanneltype IInputChannel = interface
interface IChannel
interface ICommunicationObjectPublic 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é. 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) |
