• Article

ICommunicationObject.BeginOpen Method (AsyncCallback, Object)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Begins an asynchronous operation to open a communication object.

Namespace:  System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

Syntax

'Declaration
Function BeginOpen ( _
    callback As AsyncCallback, _
    state As Object _
) As IAsyncResult

IAsyncResult BeginOpen(
    AsyncCallback callback,
    Object state
)

Parameters

  • state
    Type: System.Object
    An object, specified by the application, that contains state information associated with the asynchronous open operation.

Return Value

Type: System.IAsyncResult
The IAsyncResult that references the asynchronous open operation.

Exceptions

Exception Condition
CommunicationException

The ICommunicationObject was unable to be opened and has entered the Faulted state.
TimeoutException

The default open time-out elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

Remarks

When an ICommunicationObject is instantiated, it begins in the Created state. In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. The BeginOpen() method causes an ICommunicationObject to enter into the Opening state, where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.