MailboxProcessor.Start<'Msg> メソッド (F#)
エージェントを作成して開始します。
名前空間/モジュール パス: Microsoft.FSharp.Control
アセンブリ: FSharp.Core (FSharp.Core.dll)
// Signature:
static member Start : (MailboxProcessor<'Msg> -> Async<unit>) * ?CancellationToken -> MailboxProcessor<'Msg>
// Usage:
MailboxProcessor.Start (body)
MailboxProcessor.Start (body, cancellationToken = cancellationToken)
パラメーター
body
型: MailboxProcessor<'Msg> -> Async<unit>非同期計算を作成する関数。この計算は、Start が呼び出されたときに、MailboxProcessor の読み込みループとして実行されます。
cancellationToken
型: CancellationTokenbody の省略可能なキャンセル トークン。既定値は、Async.DefaultCancellationToken です。
戻り値
作成された MailboxProcessor。
解説
関数本体 (body) は、エージェントによって実行される非同期計算の生成に使用されます。
使用例
メールボックス プロセッサ エージェントを起動する方法のコード例を次に示します。この例では、コンソールからの各入力行がメッセージ キューにポストされます。プログラムは各メッセージを読み取り、応答チャネルを使用して応答します。特別なメッセージ "Stop" を受信すると、Stop 応答を送信し、プログラムが終了します。
open System
type Message = string * AsyncReplyChannel<string>
let formatString = "Message number {0} was received. Message contents: {1}"
let printThreadId note =
// Append the thread ID.
printfn "%d : %s" System.Threading.Thread.CurrentThread.ManagedThreadId note
let agent = MailboxProcessor<Message>.Start(fun inbox ->
let rec loop n =
async {
let! (message, replyChannel) = inbox.Receive();
printThreadId "MailboxProcessor"
if (message = "Stop") then
replyChannel.Reply("Stopping.")
else
replyChannel.Reply(String.Format(formatString, n, message))
do! loop (n + 1)
}
loop 0)
printfn "Mailbox Processor Test"
printfn "Type some text and press Enter to submit a message."
printfn "Type 'Stop' to close the program."
let rec loop() =
printf "> "
let input = Console.ReadLine()
printThreadId("Console loop")
let reply = agent.PostAndReply(fun replyChannel -> input, replyChannel)
if (reply <> "Stopping.") then
printfn "Reply: %s" reply
loop()
else
()
loop()
printfn "Press Enter to continue."
Console.ReadLine() |> ignore
セッション例を次に示します。
プラットフォーム
Windows 8、Windows 7、Windows Server 2012 で Windows Server 2008 R2
バージョン情報
F# コア ライブラリのバージョン
サポート: ポータブル 2.0、4.0