Bloqueando a execução de aplicativos usando um AsyncWaitHandle
Os aplicativos que não podem continuar a fazer outro trabalho enquanto aguardam os resultados de uma operação assíncrona devem ser bloqueados até que a operação seja concluída. Use uma das seguintes opções para bloquear o thread principal do aplicativo enquanto aguarda a conclusão de uma operação assíncrona:
Use a AsyncWaitHandle propriedade do IAsyncResult retornado pelo método BeginOperationName da operação assíncrona. Esta abordagem é demonstrada neste tópico.
Chame o método EndOperationName da operação assíncrona. Para obter um exemplo que demonstra essa abordagem, consulte Bloqueando a execução de aplicativos encerrando uma operação assíncrona.
Os aplicativos que usam um ou mais WaitHandle objetos para bloquear até que uma operação assíncrona seja concluída normalmente chamarão o método BeginOperationName , executarão qualquer trabalho que possa ser feito sem os resultados da operação e, em seguida, bloquearão até que a(s) operação(ões) assíncrona(s) seja concluída(s). Um aplicativo pode bloquear em uma única operação chamando um dos WaitOne métodos usando o AsyncWaitHandle. Para bloquear enquanto aguarda a conclusão de um conjunto de operações assíncronas, armazene os objetos associados AsyncWaitHandle em uma matriz e chame um dos WaitAll métodos. Para bloquear enquanto aguarda a conclusão de qualquer um de um conjunto de operações assíncronas, armazene os objetos associados AsyncWaitHandle em uma matriz e chame um dos 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 associado com a operação assíncrona WaitHandle . Observe que null (Nothing no Visual Basic) é passado para os BeginGetHostByNamerequestCallback parâmetros e stateObject 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.
*/
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);
}
}
}
}
' The following example demonstrates using asynchronous methods to
' get Domain Name System information for the specified host computer.
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
