Export (0) Print
Expand All

IReplyChannel Interface

Defines the interface that a channel must implement to be on the receiving side of a request-reply communication between messaging endpoints.

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

public interface IReplyChannel : IChannel, 
	ICommunicationObject

The IReplyChannel type exposes the following members.

  NameDescription
Public propertyLocalAddressGets the address on which this reply channel receives messages.
Public propertyStateGets the current state of the communication-oriented object. (Inherited from ICommunicationObject.)
Top

  NameDescription
Public methodAbortCauses a communication object to transition immediately from its current state into the closed state. (Inherited from ICommunicationObject.)
Public methodBeginClose(AsyncCallback, Object)Begins an asynchronous operation to close a communication object. (Inherited from ICommunicationObject.)
Public methodBeginClose(TimeSpan, AsyncCallback, Object)Begins an asynchronous operation to close a communication object with a specified timeout. (Inherited from ICommunicationObject.)
Public methodBeginOpen(AsyncCallback, Object)Begins an asynchronous operation to open a communication object. (Inherited from ICommunicationObject.)
Public methodBeginOpen(TimeSpan, AsyncCallback, Object)Begins an asynchronous operation to open a communication object within a specified interval of time. (Inherited from ICommunicationObject.)
Public methodBeginReceiveRequest(AsyncCallback, Object)Begins an asynchronous operation to receive an available request with a default timeout.
Public methodBeginReceiveRequest(TimeSpan, AsyncCallback, Object)Begins an asynchronous operation to receive an available request with a specified timeout.
Public methodBeginTryReceiveRequestBegins an asynchronous operation to receive a request message that has a specified time out and state object associated with it.
Public methodBeginWaitForRequestBegins an asynchronous request operation that has a specified time out and state object associated with it.
Public methodClose()Causes a communication object to transition from its current state into the closed state. (Inherited from ICommunicationObject.)
Public methodClose(TimeSpan)Causes a communication object to transition from its current state into the closed state. (Inherited from ICommunicationObject.)
Public methodEndCloseCompletes an asynchronous operation to close a communication object. (Inherited from ICommunicationObject.)
Public methodEndOpenCompletes an asynchronous operation to open a communication object. (Inherited from ICommunicationObject.)
Public methodEndReceiveRequestCompletes an asynchronous operation to receive an available request.
Public methodEndTryReceiveRequestCompletes the specified asynchronous operation to receive a request message.
Public methodEndWaitForRequestCompletes the specified asynchronous wait-for-a-request message operation.
Public methodGetProperty<T>Returns a typed object requested, if present, from the appropriate layer in the channel stack. (Inherited from IChannel.)
Public methodOpen()Causes a communication object to transition from the created state into the opened state. (Inherited from ICommunicationObject.)
Public methodOpen(TimeSpan)Causes a communication object to transition from the created state into the opened state within a specified interval of time. (Inherited from ICommunicationObject.)
Public methodReceiveRequest()Returns the context of the request received, if one is available. If a context is not available, waits until there is one available.
Public methodReceiveRequest(TimeSpan)Returns the context of the request received, if one is available. If a context is not available, waits until there is one available.
Public methodTryReceiveRequestReturns a value that indicates whether a request is received before a specified interval of time elapses.
Public methodWaitForRequestReturns a value that indicates whether a request message is received before a specified interval of time elapses.
Top

  NameDescription
Public eventClosedOccurs when the communication object completes its transition from the closing state into the closed state. (Inherited from ICommunicationObject.)
Public eventClosingOccurs when the communication object first enters the closing state. (Inherited from ICommunicationObject.)
Public eventFaultedOccurs when the communication object first enters the faulted state. (Inherited from ICommunicationObject.)
Public eventOpenedOccurs when the communication object completes its transition from the opening state into the opened state. (Inherited from ICommunicationObject.)
Public eventOpeningOccurs when the communication object first enters the opening state. (Inherited from ICommunicationObject.)
Top

The IReplyChannel interface includes synchronous and asynchronous variants of a ReceiveRequest method return an RequestContext that can be used to construct replies to received requests.

The contract includes synchronous and asynchronous variants of receive, try-to-receive and wait-for-a-message functionality.

An IReplyChannel is not necessarily bound to a single sender. Other channels and channel interfaces provide correlation between the sender and the reply channel, but the base contract makes no such restriction.

The pull model is used with an IReplyChannel to receive messages. This model consists of calling ReceiveRequest (or one of its variants) and then waiting for a message to arrive.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft