Memblokir Eksekusi Aplikasi Menggunakan AsyncWaitHandle

Aplikasi yang tidak dapat terus melakukan pekerjaan lain sambil menunggu hasil operasi asinkron harus diblokir hingga operasi selesai. Gunakan salah satu opsi berikut untuk memblokir utas utama aplikasi Anda sambil menunggu operasi asinkron selesai:

• Gunakan properti AsyncWaitHandle dari IAsyncResult yang dikembalikan oleh operasi asinkron yang dimulai dengan menggunakan metode OperationName. Pendekatan ini ditunjukkan dalam topik ini.

• Panggilkan metode EndOperationName dari operasi yang bersifat asinkron. Untuk contoh yang menunjukkan pendekatan ini, lihat Memblokir Eksekusi Aplikasi dengan Mengakhiri Operasi Asinkron.

Aplikasi yang menggunakan satu atau beberapa WaitHandle objek untuk memblokir hingga operasi asinkron selesai biasanya akan memanggil metode BeginOperationName , melakukan pekerjaan apa pun yang dapat dilakukan tanpa hasil operasi, lalu memblokir hingga operasi asinkron selesai. Aplikasi dapat menghalangi pada satu operasi dengan memanggil salah satu metode WaitOne menggunakan AsyncWaitHandle. Untuk memblokir sambil menunggu serangkaian operasi asinkron selesai, simpan objek terkait AsyncWaitHandle dalam array dan panggil salah WaitAll satu metode. Untuk memblokir sambil menunggu salah satu dari serangkaian operasi asinkron yang selesai, simpan objek terkait AsyncWaitHandle dalam array dan panggil salah satu metode WaitAny.

Contoh

Contoh kode berikut menunjukkan penggunaan metode asinkron di kelas DNS untuk mengambil informasi Sistem Nama Domain untuk komputer yang ditentukan pengguna. Contoh ini menunjukkan pemblokiran dengan menggunakan WaitHandle yang terkait dengan operasi asinkron. Perhatikan bahwa null (Nothing di Visual Basic) diteruskan untuk BeginGetHostByNamerequestCallback parameter dan stateObject karena ini tidak diperlukan saat menggunakan pendekatan ini.

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

Lihat juga

• Pola Asinkron Berbasis Peristiwa (EAP)
• Gambaran Umum Pola Asinkron Berbasis Peristiwa