IRequestChannel.BeginRequest Method (Message, AsyncCallback, Object)

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

Begins an asynchronous operation to transmit a request message to the reply-side of a request-reply message exchange.

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

Syntax

'Declaration
Function BeginRequest ( _
    message As Message, _
    callback As AsyncCallback, _
    state As Object _
) As IAsyncResult
IAsyncResult BeginRequest(
    Message message,
    AsyncCallback callback,
    Object state
)

Parameters

  • callback
    Type: System.AsyncCallback
    The AsyncCallback delegate that receives the notification of the completion of the asynchronous operation transmitting a request message.
  • state
    Type: System.Object
    An object, specified by the application, that contains state information associated with the asynchronous operation transmitting a request message.

Return Value

Type: System.IAsyncResult
The IAsyncResult that references the asynchronous message transmission.

Remarks

If the request message is larger that the maximum message size allowed by the binding being used, a QuotaExceededException is thrown. The maximum message size is set by the MaxReceivedMessageSize property. The default value is 65536 bytes.

Examples

The following code illustrates how to implement this method:

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.