ICommunicationObject 接口

定义

命名空间:

System.ServiceModel

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v8.0.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)	为系统中所有面向通信的对象（包括通道、通道管理器、工厂、侦听器和调度程序以及服务主机）定义基本状态机的协定。