ICommunicationObject.Close 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使通訊物件從其目前狀態轉換成已關閉狀態。
多載
| 名稱 | Description |
|---|---|
| Close() |
使通訊物件從其目前狀態轉換成已關閉狀態。 |
| Close(TimeSpan) |
使通訊物件從其目前狀態轉換成已關閉狀態。 |
Close()
使通訊物件從其目前狀態轉換成已關閉狀態。
public:
void Close();
public void Close();
abstract member Close : unit -> unit
Public Sub Close ()
例外狀況
預設的關閉暫停時間過去後,他們 ICommunicationObject 才得以優雅地結束比賽。
備註
此方法使 能 ICommunicationObject 優雅地從狀態 Opened 過渡到該 Closed 狀態。 此 Close 方法允許在返回前完成未完成的工作。 例如,完成傳送任何緩衝訊息)。
進入ICommunicationObjectClosing該狀態並停留在該狀態,直到完成轉換Closed。
如果預設的關閉超時在 能 ICommunicationObject 優雅關閉前就已過,則 ICommunicationObject 會被終止。
若Close在 、 或 ICommunicationObject 狀態中CreatedOpeningFaulted被呼叫,則 即ICommunicationObject中止。 若 Close 在 或 狀態下 ICommunicationObjectClosingClosed 被呼叫,呼叫會立即返回。
也有非同步的近距方法,由呼叫 BeginClose 啟動並完成 Close。
適用於
Close(TimeSpan)
使通訊物件從其目前狀態轉換成已關閉狀態。
public:
void Close(TimeSpan timeout);
public void Close(TimeSpan timeout);
abstract member Close : TimeSpan -> unit
Public Sub Close (timeout As TimeSpan)
參數
例外狀況
暫停結束後,他們 ICommunicationObject 才得以優雅地結束比賽。
備註
此方法使 能 ICommunicationObject 在指定時間區間內優雅地從該 Opened 狀態過渡到該 Closed 狀態。 此 Close 方法允許在返回前完成未完成的工作。 例如,完成傳送任何緩衝訊息)。
進入ICommunicationObjectClosing該狀態並停留在該狀態,直到完成轉換Closed。
如果逾時時間過後,無法 ICommunicationObject 優雅關閉,則 ICommunicationObject 會中止。
若Close在 、 或 ICommunicationObject 狀態中CreatedOpeningFaulted被呼叫,則 即ICommunicationObject中止。 若 Close 在 或 狀態下 ICommunicationObjectClosingClosed 被呼叫,呼叫會立即返回。
也有非同步的近距方法,由呼叫 BeginClose 啟動並完成 Close。
給實施者的注意事項
若超過指定TimeoutException值,操作必須拋出 atimeout。