ICommunicationObject 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義系統中所有通訊導向物件 (包括通道、通道管理員、處理站、接聽程式、發送器和服務主機) 的基本狀態機器合約。
public interface class ICommunicationObject
public interface ICommunicationObject
type ICommunicationObject = interface
Public Interface ICommunicationObject
- 衍生
備註
ICommunicationObject 介面會定義︰
用來起始狀態轉換的一組開啟、關閉與中止方法︰
開啟與關閉方法的非同步版本︰
提供狀態轉換通知的一組事件︰
檢查物件狀態的通用 State 屬性
屬性
State |
取得通訊導向物件的目前狀態。 |
方法
Abort() |
導致通訊物件立即從目前的狀態轉換為已關閉狀態。 |
BeginClose(AsyncCallback, Object) |
開始非同步作業以關閉通訊物件。 |
BeginClose(TimeSpan, AsyncCallback, Object) |
開始非同步作業,關閉有已指定逾時的通訊物件。 |
BeginOpen(AsyncCallback, Object) |
開始非同步作業以開啟通訊物件。 |
BeginOpen(TimeSpan, AsyncCallback, Object) |
開始非同步作業,開啟有已指定時間間隔的通訊物件。 |
Close() |
導致通訊物件從目前的狀態轉換為已關閉狀態。 |
Close(TimeSpan) |
導致通訊物件從目前的狀態轉換為已關閉狀態。 |
EndClose(IAsyncResult) |
完成非同步作業以關閉通訊物件。 |
EndOpen(IAsyncResult) |
完成非同步作業以開啟通訊物件。 |
Open() |
導致通訊物件從已建立狀態轉換為已開啟狀態。 |
Open(TimeSpan) |
在指定時間間隔內,讓通訊物件從已建立狀態轉換為已開啟狀態。 |
事件
Closed |
當通訊物件從關閉中狀態轉換為已關閉狀態完成時發生。 |
Closing |
當通訊物件第一次進入關閉中狀態時發生。 |
Faulted |
當通訊物件第一次進入錯誤狀態時發生。 |
Opened |
當通訊物件從開啟中狀態轉換為已開啟狀態結束時發生。 |
Opening |
當通訊物件第一次進入開啟中狀態時發生。 |
擴充方法
CloseHelperAsync(ICommunicationObject, TimeSpan) |
定義系統中所有通訊導向物件 (包括通道、通道管理員、處理站、接聽程式、發送器和服務主機) 的基本狀態機器合約。 |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
定義系統中所有通訊導向物件 (包括通道、通道管理員、處理站、接聽程式、發送器和服務主機) 的基本狀態機器合約。 |
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應