ICommunicationObject 介面

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v8.1.1

來源:

ICommunicationObject.cs

定義系統中所有通訊導向物件之基本狀態機器的合約，包括通道、通道管理員、工廠、接聽程式和發送器，以及服務主機。

C#

public interface ICommunicationObject

衍生

System.ServiceModel.ChannelFactory

System.ServiceModel.ChannelFactory<TChannel>

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.ChannelFactoryBase

System.ServiceModel.Channels.ChannelFactoryBase<TChannel>

System.ServiceModel.Channels.ChannelListenerBase

System.ServiceModel.Channels.ChannelListenerBase<TChannel>

System.ServiceModel.Channels.CommunicationObject

System.ServiceModel.Channels.IChannel

System.ServiceModel.Channels.IChannelFactory

System.ServiceModel.Channels.IChannelFactory<TChannel>

System.ServiceModel.Channels.IChannelListener

System.ServiceModel.Channels.IChannelListener<TChannel>

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.ClientBase<TChannel>

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.Discovery.AnnouncementClient

System.ServiceModel.Discovery.DiscoveryClient

System.ServiceModel.Federation.WSTrustChannel

System.ServiceModel.Federation.WSTrustChannelSecurityTokenProvider

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.Tokens.IssuedSecurityTokenProvider

System.ServiceModel.Security.WSTrustChannel

備註

ICommunicationObject 介面會定義：

• 起始狀態轉換的一組開啟、關閉和中止方法：

  • Open

  • Close

  • Abort

• 開啟與關閉方法的異步版本：

  • BeginOpen

  • EndOpen(IAsyncResult)

  • BeginClose

  • EndClose

• 提供狀態轉換通知的一組事件：

  • Opening

  • Opened

  • Closing

  • Closed

  • Faulted

• 檢查物件狀態的常見 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	當通訊物件第一次進入開啟狀態時發生。

適用於