RequestContext Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Provides a reply that is correlated to an incoming request.

Inheritance Hierarchy

System.Object
  System.ServiceModel.Channels.RequestContext

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

Syntax

'Declaration
Public MustInherit Class RequestContext _
    Implements IDisposable

public abstract class RequestContext : IDisposable

The RequestContext type exposes the following members.

Constructors

	Name	Description
	RequestContext	Initializes a new instance of the RequestContext class.

Top

Properties

	Name	Description
	RequestMessage	When overridden in a derived class, gets the message that contains the request.

Top

Methods

	Name	Description
	Abort	When overridden in a derived class, aborts processing the request associated with the context.
	BeginReply(Message, AsyncCallback, Object)	When overridden in a derived class, begins an asynchronous operation to reply to the request associated with the current context.
	BeginReply(Message, TimeSpan, AsyncCallback, Object)	When overridden in a derived class, begins an asynchronous operation to reply to the request associated with the current context within a specified interval of time.
	Close()	When overridden in a derived class, closes the operation that is replying to the request context associated with the current context.
	Close(TimeSpan)	When overridden in a derived class, closes the operation that is replying to the request context associated with the current context within a specified interval of time.
	Dispose	Releases resources associated with the context.
	EndReply	When overridden in a derived class, completes an asynchronous operation to reply to a request message.
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Reply(Message)	When overridden in a derived class, replies to a request message.
	Reply(Message, TimeSpan)	When overridden in a derived class, replies to a request message within a specified interval of time.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Explicit Interface Implementations

	Name	Description
	IDisposable.Dispose	Releases both managed and unmanaged resources associated with the context.

Top

Remarks

You get a request context from an IReplyChannel. Each RequestContext encapsulates the information required to reply to the request, so that you do not have to block on the channel when waiting for each request message to receive a reply.

In the request/reply model, the RequestContext object is the link between the request that comes in and the reply that goes out. When the server receives a request, it provides a RequestContext instance that represents the request to the channel. The request context contains the original request message among other useful properties. This request context is then stashed inside the OperationContext for retrieval by your service. You typically use the Current property to access the request of the current operation.

The value of the RequestContext can be nulla null reference (Nothing in Visual Basic). Because the role of the request context is to link requests to replies, it does not make sense to have a request context when you do not have a reply, and so in this case the context is set to nulla null reference (Nothing in Visual Basic). For a one-way operation on top of the request/reply model, the server receives requests but does not send back a response to the client. So if the RequestContext is nulla null reference (Nothing in Visual Basic) unexpectedly, check first whether the operation contract is IsOneWay.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

System.ServiceModel.Channels Namespace