IOutputChannel.BeginSend Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.1.0

Commence une opération asynchrone pour envoyer un message.

Surcharges

BeginSend(Message, AsyncCallback, Object)	Commence une opération asynchrone pour transmettre un message à la destination du canal de sortie.
BeginSend(Message, TimeSpan, AsyncCallback, Object)	Commence une opération asynchrone pour transmettre un message à la destination du canal de sortie dans un intervalle de temps spécifié.

BeginSend(Message, AsyncCallback, Object)

Source:

IOutputChannel.cs

Commence une opération asynchrone pour transmettre un message à la destination du canal de sortie.

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

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

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

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

Paramètres

message

Message

Message qui est envoyé sur le canal de sortie.

callback

AsyncCallback

Délégué AsyncCallback.

state

Object

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

Retours

IAsyncResult

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

Exemples

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

public IAsyncResult BeginReceiveRequest(TimeSpan timeout, AsyncCallback callback, object state)
{
    ReceiveRequestAsyncResult result = new ReceiveRequestAsyncResult(this, timeout, callback, state);
    result.Begin();
    return result;
}

Remarques

La destination des messages envoyés sur un canal de sortie est spécifiée au moment de la création du canal.

La méthode BeginSend ne garantit pas la remise d'un message au point de terminaison distant. Si les garanties de remise sont requises, utilisez le IOutputSessionChannel.

Si le message 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.

BeginSend(Message, TimeSpan, AsyncCallback, Object)

Source:

IOutputChannel.cs

Commence une opération asynchrone pour transmettre un message à la destination du canal de sortie dans un intervalle de temps spécifié.

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

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

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

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

Paramètres

message

Message

Message qui est envoyé sur le canal de sortie.

timeout

TimeSpan

TimeSpan qui spécifie le délai d'exécution de l'opération d'envoi avant dépassement du délai d'attente.

callback

AsyncCallback

Le délégué AsyncCallback qui reçoit la notification de la fin de l'envoi 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 d'envoi.

Retours

IAsyncResult

IAsyncResult qui fait référence à l'opération asynchrone d'envoi.

Exemples

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

public RequestContext EndReceiveRequest(IAsyncResult result)
{
    return ReceiveRequestAsyncResult.End(result);
}

Remarques

La destination des messages envoyés sur un canal de sortie est spécifiée au moment de la création du canal.

La méthode BeginSend ne garantit pas la remise d'un message au point de terminaison distant. Si les garanties de remise sont requises, utilisez IOutputSessionChannel.

Si le message 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.

Notes pour les responsables de l’implémentation

L'opération doit lever une TimeoutException si le timeout spécifié est dépassé.