Async.StartChild<'T> メソッド (F#)

非同期ワークフロー内で子計算を開始します。これにより、複数の非同期計算を同時に実行できます。

名前空間/モジュール パス: Microsoft.FSharp.Control

アセンブリ: FSharp.Core (FSharp.Core.dll)

// Signature:
static member StartChild : Async<'T> * ?int -> Async<Async<'T>>

// Usage:
Async.StartChild (computation)
Async.StartChild (computation, millisecondsTimeout = millisecondsTimeout)

パラメーター

  • computation
    型: Async<'T>

    子計算。

  • millisecondsTimeout
    型: int

    タイムアウト値 (ミリ秒)。指定しない場合は、Infinite に対応する既定値の -1 が使用されます。

戻り値

入力計算が完了するまで待機する新しい計算。

解説

通常、このメソッドは、F# の非同期ワークフロー内で let! 束縛のすぐ右側として使用する必要があります。

 async { 
    ...
    let! completor1 = childComputation1
    |> Async.StartChild
    let! completor2 = childComputation2
    |> Async.StartChild
    ... 
    let! result1 = completor1
    let! result2 = completor2
     ... }

このように使用した場合、StartChild の各呼び出しによって childComputation のインスタンスが開始され、操作の完了を待機する計算を表す completor オブジェクトが返されます。この completor を実行すると、childComputation の完了を待機します。

使用例

Async.StartChild の使用方法を次のコード例に示します。

open System.Windows.Forms

let bufferData = Array.zeroCreate<byte> 100000000

let asyncChild filename =
        async {
            printfn "Child job start: %s" filename
            use outputFile = System.IO.File.Create(filename)
            do! outputFile.AsyncWrite(bufferData)
            printfn "Child job end: %s " filename
        }

let asyncParent =
        async {
            printfn "Parent job start."
            let! childAsync1 = Async.StartChild(asyncChild "longoutput1.dat")
            let! childAsync2 = Async.StartChild(asyncChild "longoutput2.dat")
            let! result1 = childAsync1
            let! result2 = childAsync2
            printfn "Parent job end."
        }


let form = new Form(Text = "Test Form")
let button = new Button(Text = "Start")
form.Controls.Add(button)
button.Click.Add(fun args -> Async.Start(asyncParent)
                             printfn "Completed execution." )
Application.Run(form)

出力例

ジョブが同時に実行されるため、出力はインターリーブされます。

  
  
  

プラットフォーム

Windows 8、Windows 7、Windows Server 2012 で Windows Server 2008 R2

バージョン情報

F# コア ライブラリのバージョン

サポート: ポータブル 2.0、4.0

参照

関連項目

Control.Async クラス (F#)

Microsoft.FSharp.Control 名前空間 (F#)