Bloqueando a execução de aplicativos usando um AsyncWaitHandle
Aplicativos que não podem continuar a fazer outro trabalho enquanto aguarda os resultados de uma operação assíncrona devem bloquear até que a operação seja concluída. Para bloquear o thread principal do aplicativo enquanto aguarda uma operação assíncrona concluir, use uma das seguintes opções:
Use o AsyncWaitHandle propriedade da IAsyncResult retornado pela operação assíncrona começarOperationName método. Essa abordagem é demonstrada neste tópico.
A operação assíncrona de chamar EndOperationName método. Para obter um exemplo que demonstra essa abordagem, consulte Bloqueando a execução do aplicativo por final de uma operação assíncrona.
Aplicativos que usam um ou mais WaitHandle objetos para bloquear até que uma operação assíncrona for concluída normalmente chamará o começarOperationName método, realizar qualquer trabalho que pode ser feito sem os resultados da operação e, em seguida, bloquear até que as operações assíncrona for concluída. Um aplicativo pode bloquear em uma única operação, chamando um da WaitOne métodos usando a AsyncWaitHandle. Para bloquear enquanto aguarda a um conjunto de operações assíncronas para concluir, armazenar associado AsyncWaitHandle objetos em uma matriz e uma chamada da WaitAll métodos. Para bloquear enquanto aguarda a qualquer um de um conjunto de operações assíncronas para concluir, armazenar associado AsyncWaitHandle objetos em uma matriz e uma chamada da WaitAny métodos.
Exemplo
O exemplo de código a seguir demonstra o uso de métodos assíncronos na classe DNS para recuperar informações do sistema de nomes de domínio para um computador especificado pelo usuário. O exemplo demonstra o bloqueio usando o WaitHandle associados com a operação assíncrona. Observe que null (Nothing em Visual Basic) é passado para o BeginGetHostByName requestCallback e stateObject parâmetros porque eles não são necessários ao usar essa abordagem.
' The following example demonstrates using asynchronous methods to
' get Domain Name System information for the specified host computer.
Imports System
Imports System.Net
Imports System.Net.Sockets
Imports System.Threading
namespace Examples.AdvancedProgramming.AsynchronousOperations
Public Class WaitUntilOperationCompletes
Public Shared Sub Main(args() as String)
' Make sure the caller supplied a host name.
If(args.Length = 0)
' Print a message and exit.
Console.WriteLine("You must specify the name of a host computer.")
End
End If
' Start the asynchronous request for DNS information.
Dim result as IAsyncResult= Dns.BeginGetHostEntry(args(0), Nothing, Nothing)
Console.WriteLine("Processing request for information...")
' Wait until the operation completes.
result.AsyncWaitHandle.WaitOne()
' The operation completed. Process the results.
Try
' Get the results.
Dim host as IPHostEntry = Dns.EndGetHostEntry(result)
Dim aliases() as String = host.Aliases
Dim addresses() as IPAddress= host.AddressList
Dim i as Integer
If aliases.Length > 0
Console.WriteLine("Aliases")
For i = 0 To aliases.Length -1
Console.WriteLine("{0}", aliases(i))
Next i
End If
If addresses.Length > 0
Console.WriteLine("Addresses")
For i = 0 To addresses.Length -1
Console.WriteLine("{0}", addresses(i).ToString())
Next i
End If
Catch e as SocketException
Console.WriteLine("An exception occurred while processing the request: {0}" _
, e.Message)
End Try
End Sub
End Class
End Namespace
/*
The following example demonstrates using asynchronous methods to
get Domain Name System information for the specified host computer.
*/
using System;
using System.Net;
using System.Net.Sockets;
using System.Threading;
namespace Examples.AdvancedProgramming.AsynchronousOperations
{
public class WaitUntilOperationCompletes
{
public static void Main(string[] args)
{
// Make sure the caller supplied a host name.
if (args.Length == 0 || args[0].Length == 0)
{
// Print a message and exit.
Console.WriteLine("You must specify the name of a host computer.");
return;
}
// Start the asynchronous request for DNS information.
IAsyncResult result = Dns.BeginGetHostEntry(args[0], null, null);
Console.WriteLine("Processing request for information...");
// Wait until the operation completes.
result.AsyncWaitHandle.WaitOne();
// The operation completed. Process the results.
try
{
// Get the results.
IPHostEntry host = Dns.EndGetHostEntry(result);
string[] aliases = host.Aliases;
IPAddress[] addresses = host.AddressList;
if (aliases.Length > 0)
{
Console.WriteLine("Aliases");
for (int i = 0; i < aliases.Length; i++)
{
Console.WriteLine("{0}", aliases[i]);
}
}
if (addresses.Length > 0)
{
Console.WriteLine("Addresses");
for (int i = 0; i < addresses.Length; i++)
{
Console.WriteLine("{0}",addresses[i].ToString());
}
}
}
catch (SocketException e)
{
Console.WriteLine("Exception occurred while processing the request: {0}",
e.Message);
}
}
}
}
Consulte também
Conceitos
Event-based Asynchronous Pattern Overview