ICommunicationObject.Open 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使通訊物件從已建立的狀態轉換成開啟的狀態。
多載
| 名稱 | Description |
|---|---|
| Open() |
使通訊物件從已建立的狀態轉換成開啟的狀態。 |
| Open(TimeSpan) |
使通訊物件在指定的時間間隔內,從建立的狀態轉換成開啟的狀態。 |
備註
提供有明確逾時與不帶的版本。
Open()
使通訊物件從已建立的狀態轉換成開啟的狀態。
public:
void Open();
public void Open();
abstract member Open : unit -> unit
Public Sub Open ()
例外狀況
該車 ICommunicationObject 無法開啟,已進入 Faulted 該州。
預設的開放逾時時間在進入ICommunicationObjectOpened該州之前已經過去,且已經進入Faulted該州。
備註
當 被 ICommunicationObject 實例化時,它就從狀態 Created 開始。 在狀態中 Created ,物件可以被設定(例如設定屬性或註冊事件),但尚未能用於傳送或接收訊息。 此Open方法使 進入ICommunicationObjectOpening狀態,直到開啟操作成功、開啟操作逾時或失敗,物件出現故障,或ICommunicationObject中止為止。
在該 Opened 狀態中,是 ICommunicationObject 可用的(例如,訊息可以被接收),但已無法再設定。
還有一個非同步版本的開放方法,由呼叫 BeginOpen 啟動並由呼叫 EndOpen(IAsyncResult)完成。
適用於
Open(TimeSpan)
使通訊物件在指定的時間間隔內,從建立的狀態轉換成開啟的狀態。
public:
void Open(TimeSpan timeout);
public void Open(TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)
參數
例外狀況
該車 ICommunicationObject 無法開啟,已進入 Faulted 該州。
指定的暫停時間在進入ICommunicationObjectOpened狀態前已過,且已進入Faulted狀態。
備註
當 被 ICommunicationObject 實例化時,它就從狀態 Created 開始。 在狀態中 Created ,物件可以被設定(例如設定屬性或註冊事件),但尚未能用於傳送或接收訊息。 此Open方法使 進入ICommunicationObjectOpening狀態,直到開啟操作成功、開啟操作逾時或失敗,物件出現故障,或ICommunicationObject中止為止。
在該 Opened 狀態中,是 ICommunicationObject 可用的(例如,訊息可以被接收),但已無法再設定。
還有一個非同步版本的開放方法,由呼叫 BeginOpen 啟動並由呼叫 EndOpen(IAsyncResult)完成。
給實施者的注意事項
若超過指定TimeoutException值,操作必須拋出 atimeout。