Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 propriedade AsyncWaitHandle do IAsyncResult retornado pelo método BeginOperationName da operação assíncrona. Esta abordagem é demonstrada neste tópico.
Invoque 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 objetos WaitHandle para bloquear até que uma operação assíncrona seja concluída normalmente chamarão o métodoBegin OperationName, executarão qualquer trabalho que possa ser feito sem os resultados da operação e bloquearão até que a(s) operação(ões) assíncrona(s) seja concluída(s). Uma aplicação pode bloquear numa única operação ao chamar um dos métodos WaitOne usando o AsyncWaitHandle. Para bloquear enquanto aguarda a conclusão de um conjunto de operações assíncronas, armazene os objetos AsyncWaitHandle associados em uma matriz e chame um dos métodos WaitAll. Para bloquear enquanto aguarda a conclusão de qualquer um de um conjunto de operações assíncronas, armazene os objetos AsyncWaitHandle associados em uma matriz e chame um dos métodos WaitAny.
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 associado à operação assíncrona. Observe que null (Nothing no Visual Basic) é passado para os parâmetros BeginGetHostByNamerequestCallback 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($"{aliases[i]}");
}
}
if (addresses.Length > 0)
{
Console.WriteLine("Addresses");
for (int i = 0; i < addresses.Length; i++)
{
Console.WriteLine($"{addresses[i].ToString()}");
}
}
}
catch (SocketException e)
{
Console.WriteLine($"Exception occurred while processing the request: {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