IOutputChannel.BeginSend Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Avvia un'operazione asincrona per inviare un messaggio.

Overload

BeginSend(Message, AsyncCallback, Object)	Inizia un'operazione asincrona per trasmettere un messaggio alla destinazione del canale di output.
BeginSend(Message, TimeSpan, AsyncCallback, Object)	Inizia un'operazione asincrona per trasmettere un messaggio alla destinazione del canale di output entro l'intervallo di tempo specificato.

BeginSend(Message, AsyncCallback, Object)

Inizia un'operazione asincrona per trasmettere un messaggio alla destinazione del canale di output.

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

Parametri

message

Message

Oggetto della classe Message inviato sul canale di output.

callback

AsyncCallback

Delegato AsyncCallback.

state

Object

Oggetto, specificato dall'applicazione, che contiene le informazioni sullo stato associate all'operazione asincrona di invio.

Restituisce

IAsyncResult

Interfaccia IAsyncResult che fa riferimento alla trasmissione del messaggio asincrono.

Esempio

Nell'esempio di codice seguente viene illustrato come implementare questo metodo:

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

Commenti

La destinazione per messaggi inviati su un canale di output è specificata al momento della creazione del canale.

Il metodo BeginSend non garantisce che il messaggio venga recapitato all'endpoint remoto. Se sono necessarie garanzie di recapito, utilizzare IOutputSessionChannel.

Se il messaggio inviato è più grande rispetto alla dimensione massima del messaggio consentita dall'associazione in uso, dimensione del messaggio consentita dall'associazione utilizzata, viene generata una classe QuotaExceededException. La dimensione massima del messaggio viene impostata dalla proprietà MaxReceivedMessageSize. Il valore predefinito è 65536 byte.

BeginSend(Message, TimeSpan, AsyncCallback, Object)

Inizia un'operazione asincrona per trasmettere un messaggio alla destinazione del canale di output entro l'intervallo di tempo specificato.

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

Parametri

message

Message

Oggetto della classe Message inviato sul canale di output.

timeout

TimeSpan

L'oggetto TimeSpan che specifica il tempo disponibile per il completamento prima del timeout dell'operazione di invio.

callback

AsyncCallback

Delegato AsyncCallback che riceve la notifica del completamento dell'operazione asincrona di invio.

state

Object

Oggetto, specificato dall'applicazione, che contiene le informazioni sullo stato associate all'operazione asincrona di invio.

Restituisce

IAsyncResult

IAsyncResult fa riferimento all'operazione asincrona di invio.

Esempio

Nell'esempio di codice seguente viene illustrato come implementare questo metodo:

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

Commenti

La destinazione per messaggi inviati su un canale di output è specificata al momento della creazione del canale.

Il metodo BeginSend non garantisce che il messaggio venga recapitato all'endpoint remoto. Se sono necessarie garanzie di recapito, utilizzare IOutputSessionChannel.

Se il messaggio inviato è più grande rispetto alla dimensione massima del messaggio consentita dall'associazione in uso, dimensione del messaggio consentita dall'associazione utilizzata, viene generata una classe QuotaExceededException. La dimensione massima del messaggio viene impostata dalla proprietà MaxReceivedMessageSize. Il valore predefinito è 65536 byte.

Note per gli implementatori

L'operazione dovrebbe generare un'eccezione TimeoutException se viene superato il timeout specificato.