IReplyChannel.BeginReceiveRequest 方法

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.dll

開始非同步作業，接收可用的要求。

多載

BeginReceiveRequest(AsyncCallback, Object)	開始非同步作業，接收有預設逾時的可用要求。
BeginReceiveRequest(TimeSpan, AsyncCallback, Object)	開始非同步作業，接收有已指定逾時的可用要求。

BeginReceiveRequest(AsyncCallback, Object)

開始非同步作業，接收有預設逾時的可用要求。

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

public IAsyncResult BeginReceiveRequest (AsyncCallback callback, object state);

abstract member BeginReceiveRequest : AsyncCallback * obj -> IAsyncResult

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

參數

callback

AsyncCallback

AsyncCallback 委派，這個委派會接收要求作業完成之非同步接收的通知。

state

Object

應用程式所指定的物件，其中包含與要求作業之非同步接收相關聯的狀態資訊。

傳回

IAsyncResult

IAsyncResult，參考要求的非同步接收。

範例

下列程式碼說明如何實作這個方法：

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

備註

方法 BeginReceiveRequest(AsyncCallback, Object) 會實作以異步方式叫 ReceiveRequest() 用的標準模式。 預設的逾時值為 1 分鐘。 如果接收逾時是設定於連線設定時所用的繫結上，則會使用該值。 如果您要用會覆寫這些其他值的呼叫來指定明確的逾時，請使用BeginReceiveRequest(TimeSpan, AsyncCallback, Object)。

如果接收的要求訊息大於要使用繫結所允許的最大訊息大小，則會擲回 QuotaExceededException。 訊息大小上限是由 MaxReceivedMessageSize 屬性所設定。 預設值為 65536 個位元組。

BeginReceiveRequest(TimeSpan, AsyncCallback, Object)

開始非同步作業，接收有已指定逾時的可用要求。

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

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

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

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

參數

timeout

TimeSpan

TimeSpan，指定等候接收可用要求的時間間隔。

callback

AsyncCallback

AsyncCallback 委派，這個委派會接收要求作業完成之非同步接收的通知。

state

Object

應用程式所指定的物件，其中包含與要求作業之非同步接收相關聯的狀態資訊。

傳回

IAsyncResult

IAsyncResult，參考要求的非同步接收。

範例

下列程式碼說明如何實作這個方法：

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

備註

方法 BeginReceiveRequest(TimeSpan, AsyncCallback, Object) 會實作以異步方式叫 ReceiveRequest(TimeSpan) 用的標準模式。 使用這個方法設定的逾時，將會覆寫連線設定時所使用繫結上已設定的接收逾時。

如果接收的要求訊息大於要使用繫結所允許的最大訊息大小，則會擲回 QuotaExceededException。 訊息大小上限是由 MaxReceivedMessageSize 屬性所設定。 預設值為 65536 個位元組。