Freigeben über


Blockieren der Anwendungsausführung mithilfe einer AsyncWaitHandle

Anwendungen, die andere Arbeiten nicht fortsetzen können, während sie auf die Ergebnisse eines asynchronen Vorgangs warten, müssen blockiert werden, bis der Vorgang abgeschlossen ist. Verwenden Sie eine der folgenden Optionen, um den Hauptthread Ihrer Anwendung zu blockieren, während sie auf den Abschluss eines asynchronen Vorgangs warten:

Anwendungen, die mindestens ein WaitHandle Objekt verwenden, um zu blockieren, bis ein asynchroner Vorgang abgeschlossen ist, rufen in der Regel die BeginOperationName-Methode auf, führen jede Arbeit aus, die ohne die Ergebnisse des Vorgangs ausgeführt werden kann, und blockiert dann, bis die asynchronen Vorgänge abgeschlossen sind. Eine Anwendung kann für einen einzelnen Vorgang blockieren, indem eine der WaitOne-Methoden mithilfe AsyncWaitHandle aufgerufen wird. Wenn Sie während des Wartens auf den Abschluss einer Reihe asynchroner Vorgänge blockieren möchten, speichern Sie die zugehörigen AsyncWaitHandle Objekte in einem Array, und rufen Sie eine der WaitAll Methoden auf. Speichern Sie die zugehörigen AsyncWaitHandle Objekte in einem Array und rufen Sie eine der WaitAny Methoden auf, um zu blockieren, während auf den Abschluss eines der asynchronen Vorgänge gewartet wird.

Beispiel

Im folgenden Codebeispiel wird die Verwendung asynchroner Methoden in der DNS-Klasse zum Abrufen von Domänennamensysteminformationen für einen vom Benutzer angegebenen Computer veranschaulicht. Das Beispiel veranschaulicht das Blockieren mithilfe des mit der asynchronen Operation verbundenen WaitHandle. Beachten Sie, dass null (Nothing in Visual Basic) für die Parameter BeginGetHostByNamerequestCallback und stateObject übergeben wird, da diese bei Verwendung dieses Ansatzes nicht erforderlich sind.

/*
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

Siehe auch