Export (0) Print
Expand All

Async.FromBeginEnd<'Arg1,'T> Method (F#)

Creates an asynchronous computation in terms of a Begin/End pair of actions in the style used in CLI APIs.

Namespace/Module Path: Microsoft.FSharp.Control

Assembly: FSharp.Core (in FSharp.Core.dll)

// Signature:
static member FromBeginEnd : 'Arg1 * ('Arg1 * AsyncCallback * obj -> IAsyncResult) * (IAsyncResult -> 'T) * ?(unit -> unit) -> Async<'T>

// Usage:
Async.FromBeginEnd (arg, beginAction, endAction)
Async.FromBeginEnd (arg, beginAction, endAction, cancelAction = cancelAction)

arg

Type: 'Arg1

The argument for the operation.

beginAction

Type: 'Arg1 * AsyncCallback * obj -> IAsyncResult

The function initiating a traditional CLI asynchronous operation.

endAction

Type: IAsyncResult -> 'T

The function completing a traditional CLI asynchronous operation.

cancelAction

Type: (unit -> unit)

An optional function to be executed when a cancellation is requested.

An asynchronous computation wrapping the given Begin/End functions.

This overload should be used if the operation is qualified by one argument. For example, you can create an asynchronous computation for a web service call with the following code.

Async.FromBeginEnd(place,ws.BeginGetWeather,ws.EndGetWeather)

When the computation is run, beginFunc is executed, with a callback which represents the continuation of the computation. When the callback is invoked, the overall result is fetched using endFunc.

The computation will respond to cancellation while waiting for the completion of the operation. If a cancellation occurs, and cancelAction is specified, then it is executed, and the computation continues to wait for the completion of the operation. If cancelAction is not specified, then cancellation causes the computation to stop immediately, and subsequent invocations of the callback are ignored.

For an example, see Async.FromBeginEnd<'T> Method (F#).

Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2

F# Core Library Versions

Supported in: 2.0, 4.0, Portable

Show:
© 2014 Microsoft