CommunicationObject.BeginClose 方法

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v8.1.1

開始非同步作業以關閉通訊物件。

多載

BeginClose(AsyncCallback, Object)	開始非同步作業以關閉通訊物件。
BeginClose(TimeSpan, AsyncCallback, Object)	開始非同步作業，關閉有已指定逾時的通訊物件。

BeginClose(AsyncCallback, Object)

來源:

CommunicationObject.cs

開始非同步作業以關閉通訊物件。

C#

public IAsyncResult BeginClose(AsyncCallback callback, object state);

參數

callback

AsyncCallback

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

state

Object

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

傳回

IAsyncResult

參考非同步關閉作業的 IAsyncResult。

實作

BeginClose(AsyncCallback, Object)

例外狀況

InvalidOperationException

通訊物件並非處於 Opened 或 Opening 狀態，無法修改。

ObjectDisposedException

通訊物件處於 Closing 或 Closed 狀態，無法修改。

CommunicationObjectFaultedException

通訊物件處於 Faulted 狀態，無法修改。

TimeoutException

已超過為作業分配的預設時間間隔，該作業未完成。

備註

這個方法可以在預設時間間隔內，將 CommunicationObject 從 Closed 狀態以外的任何狀態順利轉換至 Closed 狀態。 BeginClose 方法可讓任何未完成的工作在傳回前完成 (例如，完成傳送任何經過緩衝處理的訊息)。 如果通訊物件一開始處於 OnBeginOpen(TimeSpan, AsyncCallback, Object) 狀態，這個方法就會呼叫 Opened。

BeginClose(TimeSpan, AsyncCallback, Object)

來源:

CommunicationObject.cs

開始非同步作業，關閉有已指定逾時的通訊物件。

C#

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

參數

timeout

TimeSpan

TimeSpan，指定必須在逾時前多久完成關閉作業。

callback

AsyncCallback

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

state

Object

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

傳回

IAsyncResult

參考非同步關閉作業的 IAsyncResult。

實作

BeginClose(TimeSpan, AsyncCallback, Object)

例外狀況

InvalidOperationException

通訊物件並非處於 Opened 或 Opening 狀態，無法修改。

ObjectDisposedException

通訊物件處於 Closing 或 Closed 狀態，無法修改。

CommunicationObjectFaultedException

通訊物件處於 Faulted 狀態，無法修改。

TimeoutException

已超過為作業分配的預設時間間隔，該作業未完成。

備註

這個方法可以在指定的時間間隔內，將 CommunicationObject 從 Closed 狀態以外的任何狀態順利轉換至 Closed 狀態。 BeginClose 方法可讓任何未完成的工作在傳回前完成 (例如，完成傳送任何經過緩衝處理的訊息)。 如果通訊物件一開始處於 OnBeginClose(TimeSpan, AsyncCallback, Object) 狀態，這個方法就會呼叫 Opened。