This documentation is archived and is not being maintained.

CommunicationObject.Open Method (TimeSpan)

Causes a communication object to transition from the created state into the opened state within a specified interval of time.

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

public void Open(
	TimeSpan timeout


Type: System.TimeSpan

The Timespan that specifies how long the open operation has to complete before timing out.




timeout is less than zero.


The communication object is not in a Opened or Opening state and cannot be modified.


The communication object is in a Closing or Closed state and cannot be modified.


The communication object is in a Faulted state and cannot be modified.


The interval of time specified by timeout that was allotted for the operation was exceeded before the operation was completed.

When a CommunicationObject 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. When called, the Open method causes a CommunicationObject to enter into the Opening state and calls OnOpening, Open, and OnOpened. The OnOpened method completes the Open method by setting the state of the object to the Opened state.

In the

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

There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0

.NET Compact Framework

Supported in: 3.5