Sdílet prostřednictvím


Blockieren der Anwendungsausführung mithilfe von AsyncWaitHandle

Aktualisiert: November 2007

Anwendungen, die während des Wartens auf die Ergebnisse asynchroner Operationen keine anderen Aufgaben ausführen können, müssen bis zum Abschluss der Operation blockieren. Um den Hauptthread der Anwendung zu blockieren, wenn auf den Abschluss einer asynchronen Operation gewartet wird, verwenden Sie eine der folgenden Optionen:

Anwendungen, die für das Blockieren bis zum Abschluss einer asynchronen Methode die WaitHandle-Objekte verwenden, rufen im Normalfall die BeginOperationName-Methode auf, erledigen dann bestimmte Arbeiten, für die die Ergebnisse der Operation nicht erforderlich sind, und blockieren schließlich, bis die asynchronen Operationen zum Abschluss gebracht worden sind. Eine Anwendung kann die Ausführung einer einzelnen Operation blockieren, indem sie mithilfe des AsyncWaitHandle eine der WaitOne-Methoden aufruft. Damit die Anwendung vor Abschluss mehrerer asynchroner Operationen blockiert, speichern Sie die entsprechenden AsyncWaitHandle-Objekte in einem Array und rufen eine der WaitAll-Methoden auf. Damit die Anwendung vor Abschluss einer einzelnen asynchronen Operation blockiert, speichern Sie die entsprechenden AsyncWaitHandle-Objekte in einem Array und rufen eine der WaitAny-Methoden auf.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie asynchrone Methoden in der DNS-Klasse verwendet werden, um DNS-Daten für einen vom Benutzer festgelegten Computer abzurufen. Im Beispiel wird das Blockieren mit dem der asynchronen Operation zugeordneten WaitHandle veranschaulicht. Beachten Sie, dass für den BeginGetHostByNamerequestCallback-Parameter und den stateObject-Parameter null (Nothing in Visual Basic) übergeben wird, da hier beide Parameter entbehrlich sind.

' 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);
            }
        }
    }
}

Siehe auch

Konzepte

Übersicht über ereignisbasierte asynchrone Muster

Weitere Ressourcen

Entwurfsmuster für die asynchrone Programmierung