AsyncCallback 대리자
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
해당 비동기 작업을 완료할 때 호출되는 메서드를 참조합니다.
public delegate void AsyncCallback(IAsyncResult ^ ar);public delegate void AsyncCallback(IAsyncResult ar);[System.Serializable]
public delegate void AsyncCallback(IAsyncResult ar);[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public delegate void AsyncCallback(IAsyncResult ar);type AsyncCallback = delegate of IAsyncResult -> unit[<System.Serializable>]
type AsyncCallback = delegate of IAsyncResult -> unit[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type AsyncCallback = delegate of IAsyncResult -> unitPublic Delegate Sub AsyncCallback(ar As IAsyncResult)매개 변수
- ar
- IAsyncResult
비동기 작업의 결과입니다.
- 특성
예제
다음 코드 예제는 Dns 클래스에서 비동기 메서드를 사용하여 사용자가 지정한 컴퓨터의 DNS(Domain Name System) 정보를 검색하는 방법을 보여줍니다. 이 예제에서는 ProcessDnsInformation 메서드를 참조하는 AsyncCallback 대리자를 만듭니다. 이 메서드는 DNS 정보에 대한 각 비동기 요청에 대해 한 번 호출됩니다.
/*
The following example demonstrates using asynchronous methods to
get Domain Name System information for the specified host computers.
This example uses a delegate to obtain the results of each asynchronous
operation.
*/
using System;
using System.Net;
using System.Net.Sockets;
using System.Threading;
using System.Collections.Specialized;
using System.Collections;
namespace Examples.AdvancedProgramming.AsynchronousOperations
{
public class UseDelegateForAsyncCallback
{
static int requestCounter;
static ArrayList hostData = new ArrayList();
static StringCollection hostNames = new StringCollection();
static void UpdateUserInterface()
{
// Print a message to indicate that the application
// is still working on the remaining requests.
Console.WriteLine("{0} requests remaining.", requestCounter);
}
public static void Main()
{
// Create the delegate that will process the results of the
// asynchronous request.
AsyncCallback callBack = new AsyncCallback(ProcessDnsInformation);
string host;
do
{
Console.Write(" Enter the name of a host computer or <enter> to finish: ");
host = Console.ReadLine();
if (host.Length > 0)
{
// Increment the request counter in a thread safe manner.
Interlocked.Increment(ref requestCounter);
// Start the asynchronous request for DNS information.
Dns.BeginGetHostEntry(host, callBack, host);
}
} while (host.Length > 0);
// The user has entered all of the host names for lookup.
// Now wait until the threads complete.
while (requestCounter > 0)
{
UpdateUserInterface();
}
// Display the results.
for (int i = 0; i< hostNames.Count; i++)
{
object data = hostData [i];
string message = data as string;
// A SocketException was thrown.
if (message != null)
{
Console.WriteLine("Request for {0} returned message: {1}",
hostNames[i], message);
continue;
}
// Get the results.
IPHostEntry h = (IPHostEntry) data;
string[] aliases = h.Aliases;
IPAddress[] addresses = h.AddressList;
if (aliases.Length > 0)
{
Console.WriteLine("Aliases for {0}", hostNames[i]);
for (int j = 0; j < aliases.Length; j++)
{
Console.WriteLine("{0}", aliases[j]);
}
}
if (addresses.Length > 0)
{
Console.WriteLine("Addresses for {0}", hostNames[i]);
for (int k = 0; k < addresses.Length; k++)
{
Console.WriteLine("{0}",addresses[k].ToString());
}
}
}
}
// The following method is called when each asynchronous operation completes.
static void ProcessDnsInformation(IAsyncResult result)
{
string hostName = (string) result.AsyncState;
hostNames.Add(hostName);
try
{
// Get the results.
IPHostEntry host = Dns.EndGetHostEntry(result);
hostData.Add(host);
}
// Store the exception message.
catch (SocketException e)
{
hostData.Add(e.Message);
}
finally
{
// Decrement the request counter in a thread-safe manner.
Interlocked.Decrement(ref requestCounter);
}
}
}
}
// The following example demonstrates using asynchronous methods to
// get Domain Name System information for the specified host computers.
// This example uses a delegate to obtain the results of each asynchronous
// operation.
open System
open System.Net
open System.Net.Sockets
open System.Threading
open System.Collections.Specialized
let mutable requestCounter = 0
let hostData = ResizeArray<Result<IPHostEntry, string>>()
let hostNames = StringCollection()
let updateUserInterface () =
// Print a message to indicate that the application
// is still working on the remaining requests.
printfn $"{requestCounter} requests remaining."
// The following function is called when each asynchronous operation completes.
let processDnsInformation (result: IAsyncResult) =
string result.AsyncState
|> hostNames.Add
|> ignore
try
try
// Get the results.
Dns.EndGetHostEntry result
|> Ok
|> hostData.Add
// Store the exception message.
with :? SocketException as e ->
Error e.Message
|> hostData.Add
finally
// Decrement the request counter in a thread-safe manner.
Interlocked.Decrement &requestCounter
|> ignore
// Create the delegate that will process the results of the asynchronous request.
let callBack = AsyncCallback processDnsInformation
let mutable host = " "
while host.Length > 0 do
printf " Enter the name of a host computer or <enter> to finish: "
host <- stdin.ReadLine()
if host.Length > 0 then
// Increment the request counter in a thread safe manner.
Interlocked.Increment &requestCounter |> ignore
// Start the asynchronous request for DNS information.
Dns.BeginGetHostEntry(host, callBack, host) |> ignore
// The user has entered all of the host names for lookup.
// Now wait until the threads complete.
while requestCounter > 0 do
updateUserInterface ()
// Display the results.
for i = 0 to hostNames.Count - 1 do
match hostData[i] with
| Error message ->
// A SocketException was thrown.
printfn $"Request for {hostNames[i]} returned message: {message}"
| Ok entry ->
// Get the results.
let aliases = entry.Aliases
let addresses = entry.AddressList
if aliases.Length > 0 then
printfn $"Aliases for {hostNames[i]}"
for alias in aliases do
printfn $"{alias}"
if addresses.Length > 0 then
printfn $"Addresses for {hostNames[i]}"
for address in addresses do
printfn $"{address}"
'The following example demonstrates using asynchronous methods to
'get Domain Name System information for the specified host computers.
'This example uses a delegate to obtain the results of each asynchronous
'operation.
Imports System.Net
Imports System.Net.Sockets
Imports System.Threading
Imports System.Collections.Specialized
Imports System.Collections
Namespace Examples.AdvancedProgramming.AsynchronousOperations
Public Class UseDelegateForAsyncCallback
Dim Shared requestCounter as Integer
Dim Shared hostData as ArrayList = new ArrayList()
Dim Shared hostNames as StringCollection = new StringCollection()
Shared Sub UpdateUserInterface()
' Print a message to indicate that the application
' is still working on the remaining requests.
Console.WriteLine("{0} requests remaining.", requestCounter)
End Sub
Public Shared Sub Main()
' Create the delegate that will process the results of the
' asynchronous request.
Dim callBack as AsyncCallback
Dim host as string
Dim i, j, k as Integer
callback = AddressOf ProcessDnsInformation
Do
Console.Write(" Enter the name of a host computer or <enter> to finish: ")
host = Console.ReadLine()
If host.Length > 0
' Increment the request counter in a thread safe manner.
Interlocked.Increment(requestCounter)
' Start the asynchronous request for DNS information.
Dns.BeginGetHostEntry(host, callBack, host)
End If
Loop While (host.Length > 0)
' The user has entered all of the host names for lookup.
' Now wait until the threads complete.
Do While requestCounter > 0
UpdateUserInterface()
Loop
' Display the results.
For i = 0 To hostNames.Count -1
Dim dataObject as Object = hostData (i)
Dim message as String
' Was a SocketException was thrown?
If TypeOf dataObject is String
message = CType(dataObject, String)
Console.WriteLine("Request for {0} returned message: {1}", _
hostNames(i), message)
Else
' Get the results.
Dim h as IPHostEntry = CType(dataObject, IPHostEntry)
Dim aliases() as String = h.Aliases
Dim addresses() as IPAddress = h.AddressList
If aliases.Length > 0
Console.WriteLine("Aliases for 0}", hostNames(i))
For j = 0 To aliases.Length -1
Console.WriteLine("{0}", aliases(j))
Next j
End If
If addresses.Length > 0
Console.WriteLine("Addresses for {0}", hostNames(i))
For k = 0 To addresses.Length -1
Console.WriteLine("{0}",addresses(k).ToString())
Next k
End If
End If
Next i
End Sub
' The following method is called when each asynchronous operation completes.
Shared Sub ProcessDnsInformation(result as IAsyncResult)
Dim hostName as String = CType(result.AsyncState, String)
hostNames.Add(hostName)
Try
' Get the results.
Dim host as IPHostEntry = Dns.EndGetHostEntry(result)
hostData.Add(host)
' Store the exception message.
Catch e as SocketException
hostData.Add(e.Message)
Finally
' Decrement the request counter in a thread-safe manner.
Interlocked.Decrement(requestCounter)
End Try
End Sub
End Class
End Namespace
설명
대리자를 AsyncCallback 사용하여 별도의 스레드에서 비동기 작업의 결과를 처리합니다. 대리자는 AsyncCallback 비동기 작업이 완료 될 때 호출 되는 콜백 메서드를 나타냅니다. 콜백 메서드는 이후에 비동기 작업의 결과를 가져오는 데 사용되는 매개 변수를 사용합니다 IAsyncResult .
비동기 프로그래밍에 대한 자세한 내용은 비동기 작업을 종료하기 위해 AsyncCallback 대리자 사용 및 이벤트 기반 EAP(비동기 패턴)에서 AsyncCallback 대리자 및 상태 개체 사용을 참조하세요.
확장 메서드
| GetMethodInfo(Delegate) |
지정된 대리자가 나타내는 메서드를 나타내는 개체를 가져옵니다. |