SALES: 1-800-867-1380

IConnectionStatus Interface

 

Describes the current status of a one-way connection.

Namespace:   Microsoft.ServiceBus
Assembly:  Microsoft.ServiceBus (in Microsoft.ServiceBus.dll)

public interface IConnectionStatus

NameDescription
System_CAPS_pubpropertyIsOnline

Gets a value that determines whether the connection is online.

System_CAPS_pubpropertyLastError

Retrieves the last error encountered when trying to reestablish the connection from the offline state.

NameDescription
System_CAPS_pubeventConnecting

Occurs when the connection is being established.

System_CAPS_pubeventOffline

Occurs when the connection becomes offline.

System_CAPS_pubeventOnline

Occurs when the connection becomes online.

Windows Azure Service Bus supports only Full Trust code access security.

 IConnectionStatus is a channel property you can retrieve from a one-way client or service channel by calling M:System.ServiceModel.ClientBase`1.ChannelBase`1.System.ServiceModel.Channels.IChannel.GetProperty``1. The property is present only on one-way channels created based on the NetOnewayRelayBinding, or custom bindings that use the T:Microsoft.ServiceBus.Configuration.OnewayRelayTransportElement.

The connection status is a fundamental capability of the Windows Azure Service Bus client infrastructure. For example, the duplex and request-response bindings for Net.Tcp and HTTP use the connection status as part of their base. The logic exposed through the connection status property allows the client to identify when a connection to the Windows Azure Service Bus is available. Whenever network conditions change and connectivity is lost, one-way listeners will automatically reconnect to the Windows Azure Service Bus at the next opportunity. Applications can use a single one-way listener to determine Windows Azure Service Bus connectivity for their needs.

Return to top
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft