MailboxProcessor.TryReceive <'Msg > Método (F#)
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.TryReceive : ?int -> Async<'Msg option>
// Usage:
mailboxProcessor.TryReceive ()
mailboxProcessor.TryReceive (timeout = timeout)
Parâmetros
timeout
Tipo: intUm tempo limite em milissegundos opcional.Padrão é -1 que corresponde a Infinite.
Valor de retorno
Uma computação assíncrono (objeto deAsync ) que retorna a mensagem recebida ou None se o tempo limite é excedido.
Comentários
Este método é para uso dentro do corpo de agente.Retorna None se um tempo limite é especificado e o tempo limite é excedido.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 Recebersimultânea, a TryReceive, a Verificação ou a TryScan podem ser ativos.
Exemplo
O exemplo a seguir mostra como usar TryReceive.Se uma mensagem não é recebida dentro de 10 segundos, um tempo limite ocorre e a identificação de mensagem incrementa 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 {
let! opt = inbox.TryReceive(10000);
match opt with
| None -> do! loop(n + 1)
| Some (message, replyChannel) ->
// The delay gets longer with each message, and eventually triggers a timeout.
if (message = "Stop") then
replyChannel.Reply("Stop")
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 mutable isCompleted = false
while (not isCompleted) do
printf "> "
let input = Console.ReadLine()
let reply = agent.PostAndReply(fun replyChannel -> input, replyChannel)
if (reply <> "Stop") then
printfn "Reply: %s" reply
else
isCompleted <- true
printfn "Press Enter to continue."
Console.ReadLine() |> ignore
Uma sessão exemplo seguinte.Observe que a mensagem número 2 é ignorada por causa do 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