語言

ICommunicationObject.Open 方法

定義

使通訊物件從已建立的狀態轉換成開啟的狀態。

多載

名稱 Description
Open()

使通訊物件從已建立的狀態轉換成開啟的狀態。

Open(TimeSpan)

使通訊物件在指定的時間間隔內,從建立的狀態轉換成開啟的狀態。

備註

提供有明確逾時與不帶的版本。

Open()

來源:
ICommunicationObject.cs
來源:
ICommunicationObject.cs
來源:
ICommunicationObject.cs

使通訊物件從已建立的狀態轉換成開啟的狀態。

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)

來源:
ICommunicationObject.cs
來源:
ICommunicationObject.cs
來源:
ICommunicationObject.cs

使通訊物件在指定的時間間隔內,從建立的狀態轉換成開啟的狀態。

public:
 void Open(TimeSpan timeout);
public void Open(TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)

參數

timeout
TimeSpan

那 TimeSpan 是指定傳送操作完成多久才會逾時。

例外狀況

該車 ICommunicationObject 無法開啟,已進入 Faulted 該州。

指定的暫停時間在進入ICommunicationObjectOpened狀態前已過,且已進入Faulted狀態。

備註

當 被 ICommunicationObject 實例化時,它就從狀態 Created 開始。 在狀態中 Created ,物件可以被設定(例如設定屬性或註冊事件),但尚未能用於傳送或接收訊息。 此Open方法使 進入ICommunicationObjectOpening狀態,直到開啟操作成功、開啟操作逾時或失敗,物件出現故障,或ICommunicationObject中止為止。

在該 Opened 狀態中,是 ICommunicationObject 可用的(例如,訊息可以被接收),但已無法再設定。

還有一個非同步版本的開放方法,由呼叫 BeginOpen 啟動並由呼叫 EndOpen(IAsyncResult)完成。

給實施者的注意事項

若超過指定TimeoutException值,操作必須拋出 atimeout。

適用於