IDefaultCommunicationTimeouts Interface
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Defines the interface for specifying the communication time-outs used by channels and channel managers, such as channel factories.
Assembly: System.ServiceModel (in System.ServiceModel.dll)
The IDefaultCommunicationTimeouts type exposes the following members.
| Name | Description | |
|---|---|---|
 | CloseTimeout | Gets the interval of time after which the close method, invoked by a communication object, times out. |
| OpenTimeout | Gets the interval of time after which the open method, invoked by a communication object, times out. |
| ReceiveTimeout | Gets the interval of time after which the receive method, invoked by a communication object, times out. |
| SendTimeout | Gets the interval of time after which the send method, invoked by a communication object, times out. |
This interface has four read-only properties that provide default time-out values for the open, send, receive, and close methods that can be called on a communication object. Each implementation is responsible for obtaining the default values in whatever manner is appropriate for the implementation. This interface is implemented by ChannelBase, the base implementation for writing custom channels, and the ChannelManagerBase, the base implementation for writing custom channel managers that derive from ChannelFactoryBase. The interface is also implemented by the Binding class and then inherited from there by CustomBinding and the system-provided bindings, such as BasicHttpBinding.
When you use channels directly, you have the ability to explicitly specify time-outs for each channel or for each operation, or on any other custom basis. When using the channel model, time-outs are quite accessible when you want to control them.
When using the service model, on the other hand, you program against services and contracts, and time-outs are more in the background. They are controlled by the infrastructure machinery that flows time-outs from place to place on your behalf. IDefaultCommunicationTimeouts is one mechanism for providing that flow.
Capabilities
If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.
ID_CAP_NETWORKING | Windows Phone 8, Windows Phone OS 7.1 |
For more info, see App capabilities and hardware requirements for Windows Phone 8.