CommunicationObject.Close 方法

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

組件:

System.ServiceModel.dll

導致通訊物件從目前的狀態轉換為已關閉狀態。

多載

Close()	導致通訊物件從目前的狀態轉換為已關閉狀態。
Close(TimeSpan)	在指定時間間隔內，讓通訊物件從目前的狀態轉換為已關閉狀態。

Close()

導致通訊物件從目前的狀態轉換為已關閉狀態。

public:
 virtual void Close();

public void Close ();

abstract member Close : unit -> unit
override this.Close : unit -> unit

Public Sub Close ()

實作

Close()

例外狀況

InvalidOperationException

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

ObjectDisposedException

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

CommunicationObjectFaultedException

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

TimeoutException

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

備註

這個方法會讓 CommunicationObject 從 Closed 狀態以外的任何狀態順利轉換至 Closed 狀態。 Close 方法可讓任何未完成的工作在傳回前完成 (例如，完成傳送任何經過緩衝處理的訊息)。

在呼叫 CommunicationObject 方法後，Closing 會進入並維持 Close 狀態，直到轉換至 Closed 狀態完成為止。 轉換包含對於 OnClosing、OnClose(TimeSpan) 和 OnClosed 進行後續呼叫。

也有非同步的方式可用於關閉方法，亦即藉由呼叫 BeginClose 啟始。

Close(TimeSpan)

在指定時間間隔內，讓通訊物件從目前的狀態轉換為已關閉狀態。

public:
 virtual void Close(TimeSpan timeout);

public void Close (TimeSpan timeout);

abstract member Close : TimeSpan -> unit
override this.Close : TimeSpan -> unit

Public Sub Close (timeout As TimeSpan)

參數

timeout

TimeSpan

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

實作

Close(TimeSpan)

例外狀況

InvalidOperationException

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

ObjectDisposedException

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

CommunicationObjectFaultedException

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

TimeoutException

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

備註

這個方法可在指定時間間隔內，將 CommunicationObject 從 Closed 狀態以外的任何狀態順利轉換至 Closed 狀態。 Close 方法可讓任何未完成的工作在傳回前完成 (例如，完成傳送任何經過緩衝處理的訊息)。

在呼叫 CommunicationObject 方法後，Closing 會進入並維持 Close 狀態，直到轉換至 Closed 狀態完成為止。 轉換包含對於 OnClosing、OnClose(TimeSpan) 和 OnClosed 進行後續呼叫。

也有非同步的方式可用於關閉方法，亦即藉由呼叫 BeginClose 啟始。