Export (0) Print
Expand All

IOutputChannel.BeginSend Method (Message, TimeSpan, AsyncCallback, Object)

Begins an asynchronous operation to transmit a message to the destination of the output channel within a specified interval of time.

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

IAsyncResult BeginSend(
	Message message,
	TimeSpan timeout,
	AsyncCallback callback,
	Object state
)

Parameters

message
Type: System.ServiceModel.Channels.Message

The Message being sent on the output channel.

timeout
Type: System.TimeSpan

The Timespan that specifies how long the send operation has to complete before timing out.

callback
Type: System.AsyncCallback

The AsyncCallback delegate that receives the notification of the asynchronous operation send completion.

state
Type: System.Object

An object, specified by the application, that contains state information associated with the asynchronous send operation.

Return Value

Type: System.IAsyncResult
The IAsyncResult that references the asynchronous send operation.

The destination for messages sent out on an output channel is specified at channel creation time.

The BeginSend method does not guarantee the delivery of message to the remote endpoint. If delivery guarantees are required, use IOutputSessionChannel.

If the message sent 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.

Notes to Implementers

The operation should throw a TimeoutException if the specified timeout is exceeded.

The following code illustrates how to implement this method:

public RequestContext EndReceiveRequest(IAsyncResult result)
{
    return ReceiveRequestAsyncResult.End(result);
}

.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

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, 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