IInputChannel.Receive Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Returns a message received by the input channel, if one is available with an interval of time that is explicitly or implicitly defined.
This member is overloaded. For complete information about this member, including syntax, usage, and examples, click a name in the overload list.
| Name | Description | |
|---|---|---|
|
Receive | Returns the message received, if one is available. If a message is not available, blocks for a default interval of time. |
|
Receive(TimeSpan) | Returns the message received, if one is available. If a message is not available, blocks for a specified interval of time. |
| Exception | Condition |
|---|---|
| CommunicationException | The input channel failed. |
| CommunicationObjectAbortedException | The input channel has been aborted. |
| CommunicationObjectFaultedException | The input channel faulted. |
Use the synchronous Receive method when it is acceptable for the current thread to be blocked until it receives the request message or exceeds the interval of time specified by timeout. Use the asynchronous BeginReceive(AsyncCallback, Object) method when you want the application processing to continue without waiting for the request to be received.
The synchronous Receive operation is available with or without an explicit timeout.
If a message is not available, it blocks until one is available or until the timeout is exceeded.