ICommunicationObject 介面

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v6.2.0

Source:

ICommunicationObject.cs

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

public interface class ICommunicationObject

public interface ICommunicationObject

type ICommunicationObject = interface

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.IAsyncChannelFactory

System.ServiceModel.Channels.IAsyncInputChannel

System.ServiceModel.Channels.IAsyncOutputChannel

System.ServiceModel.Channels.IAsyncOutputSessionChannel

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.Channels.OutputChannel

System.ServiceModel.Channels.ServiceChannelProxy

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.IAsyncCommunicationObject

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	當通訊物件第一次進入開啟中狀態時發生。

擴充方法

CloseHelperAsync(ICommunicationObject, TimeSpan)	定義系統中所有通訊導向物件 (包括通道、通道管理員、處理站、接聽程式、發送器和服務主機) 的基本狀態機器合約。
OpenHelperAsync(ICommunicationObject, TimeSpan)	定義系統中所有通訊導向物件 (包括通道、通道管理員、處理站、接聽程式、發送器和服務主機) 的基本狀態機器合約。