IRequestChannel.BeginRequest Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Lance une opération asynchrone pour transmettre un message de demande du point de vue de la réponse d'un échange de messages de demande-réponse.

Surcharges

BeginRequest(Message, AsyncCallback, Object)	Lance une opération asynchrone pour transmettre un message de demande du point de vue de la réponse d'un échange de messages de demande-réponse.
BeginRequest(Message, TimeSpan, AsyncCallback, Object)	Lance une opération asynchrone pour transmettre un message de demande du point de vue réponse d'un échange de messages de demande-réponse, dans un intervalle de temps spécifié.

BeginRequest(Message, AsyncCallback, Object)

Lance une opération asynchrone pour transmettre un message de demande du point de vue de la réponse d'un échange de messages de demande-réponse.

public:
 IAsyncResult ^ BeginRequest(System::ServiceModel::Channels::Message ^ message, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginRequest (System.ServiceModel.Channels.Message message, AsyncCallback callback, object state);

abstract member BeginRequest : System.ServiceModel.Channels.Message * AsyncCallback * obj -> IAsyncResult

Public Function BeginRequest (message As Message, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

message

Message

Demande Message à transmettre.

callback

AsyncCallback

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

state

Object

Objet, spécifié par l'application, qui contient les informations d'état associées à l'opération asynchrone transmettant un message de demande.

Retours

IAsyncResult

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

Exemples

Le code suivant illustre l'implémentation de la méthode.

public IAsyncResult BeginRequest(Message message,
    AsyncCallback callback, object state)
{
    return this.InnerChannel.BeginRequest(message,
        callback, state);
}

Remarques

Si le message de demande envoyé dépasse la taille maximale de message autorisée par la liaison utilisée, une QuotaExceededException est levée. La taille maximale du message est définie par la propriété MaxReceivedMessageSize. La valeur par défaut est 65536 octets.

BeginRequest(Message, TimeSpan, AsyncCallback, Object)

Lance une opération asynchrone pour transmettre un message de demande du point de vue réponse d'un échange de messages de demande-réponse, dans un intervalle de temps spécifié.

public:
 IAsyncResult ^ BeginRequest(System::ServiceModel::Channels::Message ^ message, TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginRequest (System.ServiceModel.Channels.Message message, TimeSpan timeout, AsyncCallback callback, object state);

abstract member BeginRequest : System.ServiceModel.Channels.Message * TimeSpan * AsyncCallback * obj -> IAsyncResult

Public Function BeginRequest (message As Message, timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

message

Message

Demande Message à transmettre.

timeout

TimeSpan

TimeSpan qui spécifie l'intervalle de temps au cours duquel une réponse doit être reçue.

callback

AsyncCallback

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

state

Object

Objet, spécifié par l'application, qui contient les informations d'état associées à l'opération asynchrone transmettant un message de demande.

Retours

IAsyncResult

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

Exemples

Le code suivant illustre l'implémentation de la méthode :

public IAsyncResult BeginRequest(Message message,
    TimeSpan timeout, AsyncCallback callback,
    object state)
{
    return this.InnerChannel.BeginRequest(message,
        timeout, callback, state);
}

Remarques

Si le message de demande envoyé dépasse la taille maximale de message autorisée par la liaison utilisée, une QuotaExceededException doit être levée. La taille maximale du message est définie par la propriété MaxReceivedMessageSize. La valeur par défaut est 65536 octets.

Si un timeout est passé lors de l'appel de la fonction, cette valeur est utilisée. Si le SendTimeout est défini sur la liaison, la valeur sur la liaison est utilisée si aucun timeout n’est spécifié lors de l’appel de la fonction.

Le DefaultSendTimeout est utilisé si aucun délai d’attente n’est spécifié sur la liaison ou lors de l’appel de la fonction. Cette valeur par défaut est 1 minute.

Notes pour les responsables de l’implémentation

L'opération doit lever une TimeoutException si le timeout spécifié est dépassé avant que l'opération soit effectuée.