ICommunicationObject.Open 方法

定义

命名空间:

System.ServiceModel

程序集:

System.ServiceModel.Primitives.dll

程序集:

System.ServiceModel.dll

使通信对象从已创建状态转换到已打开状态。

重载

Open()	使通信对象从已创建状态转换到已打开状态。
Open(TimeSpan)	使通信对象在指定时间间隔内从已创建状态转换到已打开状态。

注解

提供了有显式超时和没有显式超时两个版本。

Open()

使通信对象从已创建状态转换到已打开状态。

public:
 void Open();

public void Open ();

abstract member Open : unit -> unit

Public Sub Open ()

例外

CommunicationException

ICommunicationObject 无法打开并且已进入 Faulted 状态。

TimeoutException

在 ICommunicationObject（已经进入 Opened 状态）能够进入 Faulted 状态之前所经过的默认打开超时。

注解

ICommunicationObject实例化时，它将以Created状态开始。 在处于 Created 状态时，可以配置此对象（例如，可以设置属性或注册事件），但仍不能用此对象发送或接收消息。 该方法Open导致进入ICommunicationObjectOpening其保持状态，直到打开操作成功，打开操作超时或失败，对象出错或ICommunicationObject中止。

在 Opened 状态中， ICommunicationObject 可以使用 (例如，可以接收消息) ，但它不再可配置。

还有一个打开方法的异步版本，该方法可通过调用 BeginOpen 来启动并通过调用 EndOpen(IAsyncResult) 来完成。

Open(TimeSpan)

使通信对象在指定时间间隔内从已创建状态转换到已打开状态。

public:
 void Open(TimeSpan timeout);

public void Open (TimeSpan timeout);

abstract member Open : TimeSpan -> unit

Public Sub Open (timeout As TimeSpan)

参数

timeout

TimeSpan

TimeSpan，指定在超时前必须完成发送操作的时间。

例外

CommunicationException

ICommunicationObject 无法打开并且已进入 Faulted 状态。

TimeoutException

在 ICommunicationObject（已经进入 Opened 状态）能够进入 Faulted 状态之前所经过的指定超时。

注解

ICommunicationObject实例化时，它将以Created状态开始。 在处于 Created 状态时，可以配置此对象（例如，可以设置属性或注册事件），但仍不能用此对象发送或接收消息。 该方法Open导致进入ICommunicationObjectOpening其保持状态，直到打开操作成功，打开操作超时或失败，对象出错或ICommunicationObject中止。

在 Opened 状态中， ICommunicationObject 可以使用 (例如，可以接收消息) ，但它不再可配置。

还有一个打开方法的异步版本，该方法可通过调用 BeginOpen 来启动并通过调用 EndOpen(IAsyncResult) 来完成。

实施者说明

如果超出指定timeout值，该操作必须引发TimeoutException。