IOutputChannel.BeginSend Metode

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Memulai operasi asinkron untuk mengirim pesan.

Overload

BeginSend(Message, AsyncCallback, Object)	Memulai operasi asinkron untuk mengirimkan pesan ke tujuan saluran output.
BeginSend(Message, TimeSpan, AsyncCallback, Object)	Memulai operasi asinkron untuk mengirimkan pesan ke tujuan saluran output dalam interval waktu yang ditentukan.

BeginSend(Message, AsyncCallback, Object)

Sumber:

IOutputChannel.cs

Memulai operasi asinkron untuk mengirimkan pesan ke tujuan saluran 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

Parameter

message

Message

yang Message dikirim pada saluran output.

callback

AsyncCallback

Delegasi AsyncCallback .

state

Object

Objek, yang ditentukan oleh aplikasi, yang berisi informasi status yang terkait dengan operasi pengiriman asinkron.

Mengembalikan

IAsyncResult

IAsyncResult yang mereferensikan transmisi pesan asinkron.

Contoh

Kode berikut menggambarkan cara menerapkan metode ini:

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

Keterangan

Tujuan pesan yang dikirim pada saluran output ditentukan pada waktu pembuatan saluran.

Metode BeginSend ini tidak menjamin pengiriman pesan ke titik akhir jarak jauh. Jika jaminan pengiriman diperlukan, gunakan IOutputSessionChannel.

Jika pesan yang dikirim lebih besar sehingga ukuran pesan maksimum yang diizinkan oleh pengikatan yang digunakan, akan QuotaExceededException dilemparkan. Ukuran pesan maksimum diatur oleh MaxReceivedMessageSize properti . Nilai defaultnya adalah 65536 byte.

BeginSend(Message, TimeSpan, AsyncCallback, Object)

Sumber:

IOutputChannel.cs

Memulai operasi asinkron untuk mengirimkan pesan ke tujuan saluran output dalam interval waktu yang ditentukan.

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

Parameter

message

Message

yang Message dikirim pada saluran output.

timeout

TimeSpan

TimeSpan yang menentukan berapa lama operasi pengiriman harus diselesaikan sebelum waktu habis.

callback

AsyncCallback

AsyncCallback Delegasi yang menerima pemberitahuan penyelesaian pengiriman operasi asinkron.

state

Object

Objek, yang ditentukan oleh aplikasi, yang berisi informasi status yang terkait dengan operasi pengiriman asinkron.

Mengembalikan

IAsyncResult

IAsyncResult yang mereferensikan operasi pengiriman asinkron.

Contoh

Kode berikut menggambarkan cara menerapkan metode ini:

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

Keterangan

Tujuan pesan yang dikirim pada saluran output ditentukan pada waktu pembuatan saluran.

Metode BeginSend ini tidak menjamin pengiriman pesan ke titik akhir jarak jauh. Jika jaminan pengiriman diperlukan, gunakan IOutputSessionChannel.

Jika pesan yang dikirim lebih besar sehingga ukuran pesan maksimum yang diizinkan oleh pengikatan yang digunakan, akan QuotaExceededException dilemparkan. Ukuran pesan maksimum diatur oleh MaxReceivedMessageSize properti . Nilai defaultnya adalah 65536 byte.

Catatan Bagi Implementer

Operasi harus melempar TimeoutException jika yang ditentukan timeout terlampaui.