IInputChannel.BeginReceive Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Débute une opération de réception asynchrone.

Surcharges

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.

Remarques

Utilisez la méthode asynchrone BeginReceive lorsque vous souhaitez que le traitement de l'application se poursuive sans attendre la réception de la demande. Utilisez la méthode Receive synchrone lorsque le thread en cours peut faire l’objet d’un blocage jusqu’à ce que le message de demande soit reçu ou que l’intervalle de temps spécifié par le timeout soit dépassé. L'opération asynchrone est disponible avec ou sans délai d'attente explicite.

BeginReceive(AsyncCallback, Object)

Commence une opération asynchrone pour recevoir un message auquel est associé un objet d'état.

public:
 IAsyncResult ^ BeginReceive(AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceive (AsyncCallback callback, object state);

abstract member BeginReceive : AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

callback

AsyncCallback

Le délégué AsyncCallback qui reçoit la notification de la fin de l'opération asynchrone.

state

Object

Objet, spécifié par l'application, qui contient des informations d'état associées à l'opération asynchrone.

Retours

IAsyncResult

IAsyncResult qui fait référence à la réception asynchrone du message.

Exemples

Le code suivant illustre comment implémenter cette méthode :

public IAsyncResult BeginReceive(AsyncCallback callback, object state)
{
    return BeginReceive(DefaultReceiveTimeout, callback, state);
}

Remarques

Utilisez la méthode asynchrone BeginReceive lorsque vous souhaitez que le traitement de l'application se poursuive sans attendre la réception de la demande. Utilisez la méthode Receive synchrone lorsque le thread en cours peut faire l’objet d’un blocage jusqu’à ce que le message de demande soit reçu ou que l’intervalle de temps spécifié par le timeout soit dépassé. L'opération asynchrone est disponible avec ou sans délai d'attente explicite.

Cette méthode reçoit, via un rappel, la notification de l'identité du gestionnaire d'événements de l'opération. L'opération n'est pas terminée tant qu'un message n'est pas disponible dans le canal.

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.

public:
 IAsyncResult ^ BeginReceive(TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceive (TimeSpan timeout, AsyncCallback callback, object state);

abstract member BeginReceive : TimeSpan * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

timeout

TimeSpan

TimeSpan qui spécifie la durée d'attente pour qu'un message soit disponible.

callback

AsyncCallback

Le délégué AsyncCallback qui reçoit la notification de la fin de l'opération asynchrone.

state

Object

Objet, spécifié par l'application, qui contient des informations d'état associées à l'opération asynchrone.

Retours

IAsyncResult

IAsyncResult qui fait référence à l'opération asynchrone de réception.

Exceptions

TimeoutException

Le timeout spécifié est dépassé avant que l'opération soit effectuée.

ArgumentOutOfRangeException

Le délai d'attente spécifié est inférieur à zéro.

Exemples

Le code suivant illustre comment implémenter cette méthode :

public IAsyncResult BeginReceive(TimeSpan timeout, AsyncCallback callback, object state)
{
    ReceiveAsyncResult<TChannel> result = new ReceiveAsyncResult<TChannel>(this, timeout, callback, state);
    result.Begin();
    return result;
}

Remarques

Utilisez la méthode asynchrone BeginReceive lorsque vous souhaitez que le traitement de l'application se poursuive sans attendre la réception de la demande. Utilisez la méthode Receive synchrone lorsque le thread en cours peut faire l’objet d’un blocage jusqu’à ce que le message de demande soit reçu ou que l’intervalle de temps spécifié par le timeout soit dépassé. L'opération asynchrone est disponible avec ou sans délai d'attente explicite.

L'opération ne se termine que lorsqu'un message est disponible dans le canal ou lorsque le délai d'attente a expiré.

Notes pour les responsables de l’implémentation

L'opération lève une TimeoutException si le timeout spécifié est dépassé avant qu'elle ne se termine.