MailboxProcessor.Receive <'Msg > Método (F#)

Artigo
02/25/2013

Para uma mensagem pára.Isso consumirá a primeira mensagem na ordem de chegada.

Namespace/Module Path: Microsoft.FSharp.Control

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

// Signature:
member this.Receive : ?int -> Async<'Msg>

// Usage:
mailboxProcessor.Receive ()
mailboxProcessor.Receive (timeout = timeout)

Parâmetros

timeout
Tipo: int

Um tempo limite em milissegundos opcional.Padrão é -1 que corresponde a Infinite.

Exceções

Exceção	Condição
TimeoutException	Acionada quando o tempo limite é excedido.

Valor de retorno

Uma computação assíncrono (objeto deAsync ) que retorna a mensagem recebida.

Comentários

Este método é para uso dentro do corpo de agente.Para cada agente, no máximo um leitor simultânea pode ser ativo, o que não mais do que uma chamada a Receivesimultânea, a TryReceive, a Verificação ou a TryScan podem ser ativos.

Exemplo

O exemplo a seguir mostra como usar o método de Receive .Em esse caso, um tempo limite de 10 segundos é especificado.Geralmente, o executa a função de processamento de mensagens em um segmento diferente de postagem funcionam, portanto você deve capturar a exceção de tempo limite na função do processador de mensagem.Em esse exemplo, a exceção de tempo limite faz com que apenas o loop continuar, e aumenta o número de mensagem por 1.

open System

type Message = string * AsyncReplyChannel<string>

let formatString = "Message number {0} was received. Message contents: {1}"

let agent = MailboxProcessor<Message>.Start(fun inbox ->
    let rec loop n =
        async {            
            try
                let! (message, replyChannel) = inbox.Receive(10000);

                if (message = "Stop") then
                    replyChannel.Reply("Stop")
                else
                    replyChannel.Reply(String.Format(formatString, n, message))
                do! loop (n + 1)

            with
            | :? TimeoutException -> 
                printfn "The mailbox processor timed out."
                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()
    let reply = agent.PostAndReply(fun replyChannel -> input, replyChannel)
    if (reply <> "Stop") then
        printfn "Reply: %s" reply
        loop()
    else
        ()
loop()

printfn "Press Enter to continue."
Console.ReadLine() |> ignore

Uma maneira comum sessão.Observe que a mensagem 2 é ignorada, devido ao tempo limite.

Plataformas

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

Informações de Versão

Versões da biblioteca principal de F#

Suportado em: 2,0, 4,0, portáteis

Consulte também

Referência

Control.MailboxProcessor <'Msg > Classe (F#)

Microsoft.FSharp.Control Namespace (F#)

Compartilhar via