CommunicationObject.BeginClose CommunicationObject.BeginClose CommunicationObject.BeginClose CommunicationObject.BeginClose Method

定義

通信オブジェクトを閉じるための非同期操作を開始します。Begins an asynchronous operation to close a communication object.

オーバーロード

BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object)

通信オブジェクトを閉じるための非同期操作を開始します。Begins an asynchronous operation to close a communication object.

BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object)

タイムアウトを指定して、通信オブジェクトをクローズするための非同期操作を開始します。Begins an asynchronous operation to close a communication object with a specified timeout.

BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object)

通信オブジェクトを閉じるための非同期操作を開始します。Begins an asynchronous operation to close a communication object.

public:
 virtual IAsyncResult ^ BeginClose(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginClose (AsyncCallback callback, object state);
abstract member BeginClose : AsyncCallback * obj -> IAsyncResult
override this.BeginClose : AsyncCallback * obj -> IAsyncResult
Public Function BeginClose (callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

callback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

非同期のクローズ操作の完了通知を受信する AsyncCallback デリゲート。The AsyncCallback delegate that receives notification of the completion of the asynchronous close operation.

state
Object Object Object Object

非同期のクローズ操作に関連付けられている状態情報を保持する、アプリケーションで指定されたオブジェクト。An object, specified by the application, that contains state information associated with the asynchronous close operation.

戻り値

非同期の close 操作を参照する IAsyncResultThe IAsyncResult that references the asynchronous close operation.

実装

例外

通信オブジェクトは、Opened 状態または Opening 状態ではなく、変更できません。The communication object is not in a Opened or Opening state and cannot be modified.

通信オブジェクトは、Closing 状態または Closed 状態であり、変更できません。The communication object is in a Closing or Closed state and cannot be modified.

通信オブジェクトは、Faulted 状態であり、変更できません。The communication object is in a Faulted state and cannot be modified.

操作に割り当てられている既定の時間が、操作が完了する前に経過しました。The default interval of time that was allotted for the operation was exceeded before the operation was completed.

注釈

このメソッドは、CommunicationObject を、Closed 状態以外の任意の状態から Closed 状態に、既定の時間内で正常に遷移させます。This method causes the CommunicationObject to gracefully transition from any state, other than the Closed state, into the Closed state within a default interval of time. BeginClose メソッドにより、戻る前に未完了の作業を完了できます。The BeginClose method allows any unfinished work to be completed before returning. たとえば、バッファー内のメッセージの送信を完了します)。For example, finish sending any buffered messages). 通信オブジェクトが最初に OnBeginOpen(TimeSpan, AsyncCallback, Object) 状態だった場合、このメソッドは Opened を呼び出します。This method calls OnBeginOpen(TimeSpan, AsyncCallback, Object) if the communication object was initially in the Opened state.

BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object)

タイムアウトを指定して、通信オブジェクトをクローズするための非同期操作を開始します。Begins an asynchronous operation to close a communication object with a specified timeout.

public:
 virtual IAsyncResult ^ BeginClose(TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginClose (TimeSpan timeout, AsyncCallback callback, object state);
abstract member BeginClose : TimeSpan * AsyncCallback * obj -> IAsyncResult
override this.BeginClose : TimeSpan * AsyncCallback * obj -> IAsyncResult
Public Function BeginClose (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

クローズ操作がタイムアウトになるまでの時間を表す TimeSpanThe TimeSpan that specifies how long the close operation has to complete before timing out.

callback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

非同期のクローズ操作の完了通知を受信する AsyncCallback デリゲート。The AsyncCallback delegate that receives notification of the completion of the asynchronous close operation.

state
Object Object Object Object

非同期のクローズ操作に関連付けられている状態情報を保持する、アプリケーションで指定されたオブジェクト。An object, specified by the application, that contains state information associated with the asynchronous close operation.

戻り値

非同期の close 操作を参照する IAsyncResultThe IAsyncResult that references the asynchronous close operation.

実装

例外

通信オブジェクトは、Opened 状態または Opening 状態ではなく、変更できません。The communication object is not in a Opened or Opening state and cannot be modified.

通信オブジェクトは、Closing 状態または Closed 状態であり、変更できません。The communication object is in a Closing or Closed state and cannot be modified.

通信オブジェクトは、Faulted 状態であり、変更できません。The communication object is in a Faulted state and cannot be modified.

操作に割り当てられている既定の時間が、操作が完了する前に経過しました。The default interval of time that was allotted for the operation was exceeded before the operation was completed.

注釈

このメソッドは、CommunicationObject を、Closed 状態以外の任意の状態から Closed 状態に、指定した時間内で正常に遷移させます。This method causes the CommunicationObject to gracefully transition from any state, other than the Closed state, into the Closed state with in a specified interval of time. BeginClose メソッドにより、戻る前に未完了の作業を完了できます。The BeginClose method allows any unfinished work to be completed before returning. たとえば、バッファー内のメッセージの送信を完了します)。For example, finish sending any buffered messages). 通信オブジェクトが最初に OnBeginClose(TimeSpan, AsyncCallback, Object) 状態だった場合、このメソッドは Opened を呼び出します。This method calls OnBeginClose(TimeSpan, AsyncCallback, Object) if the communication object was initially in the Opened state.

適用対象