HttpListener.BeginGetContext(AsyncCallback, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnt asynchrones Abrufen einer eingehenden Anforderung.
public:
IAsyncResult ^ BeginGetContext(AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginGetContext(AsyncCallback? callback, object? state);public IAsyncResult BeginGetContext(AsyncCallback callback, object state);member this.BeginGetContext : AsyncCallback * obj -> IAsyncResultPublic Function BeginGetContext (callback As AsyncCallback, state As Object) As IAsyncResultParameter
- callback
- AsyncCallback
Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn eine Clientanforderung verfügbar ist.
- state
- Object
Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an den callback Delegaten übergeben, wenn der Vorgang abgeschlossen ist.
Gibt zurück
Ein IAsyncResult Objekt, das den Status des asynchronen Vorgangs angibt.
Ausnahmen
Fehler bei einem Win32-Funktionsaufruf. Überprüfen Sie die Eigenschaft der Ausnahme, um die Ursache der Ausnahme ErrorCode zu ermitteln.
Dieses Objekt wurde nicht gestartet oder wird zurzeit beendet.
Dieses Objekt ist geschlossen.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der BeginGetContext Methode zum Angeben einer Rückrufmethode veranschaulicht, die eingehende Clientanforderungen verarbeitet.
public static void NonblockingListener(string [] prefixes)
{
HttpListener listener = new HttpListener();
foreach (string s in prefixes)
{
listener.Prefixes.Add(s);
}
listener.Start();
IAsyncResult result = listener.BeginGetContext(new AsyncCallback(ListenerCallback),listener);
// Applications can do some work here while waiting for the
// request. If no work can be done until you have processed a request,
// use a wait handle to prevent this thread from terminating
// while the asynchronous operation completes.
Console.WriteLine("Waiting for request to be processed asyncronously.");
result.AsyncWaitHandle.WaitOne();
Console.WriteLine("Request processed asyncronously.");
listener.Close();
}
Public Shared Sub NonblockingListener(ByVal prefixes As String())
Dim listener As HttpListener = New HttpListener()
For Each s As String In prefixes
listener.Prefixes.Add(s)
Next
listener.Start()
Dim result As IAsyncResult = listener.BeginGetContext(New AsyncCallback(AddressOf ListenerCallback), listener)
' Applications can do some work here while waiting for the
' request. If no work can be done until you have processed a request,
' use a wait handle to prevent this thread from terminating
' while the asynchronous operation completes.
Console.WriteLine("Waiting for request to be processed asyncronously.")
result.AsyncWaitHandle.WaitOne()
Console.WriteLine("Request processed asyncronously.")
listener.Close()
End Sub
Im folgenden Codebeispiel wird eine Rückrufmethode implementiert.
public static void ListenerCallback(IAsyncResult result)
{
HttpListener listener = (HttpListener) result.AsyncState;
// Call EndGetContext to complete the asynchronous operation.
HttpListenerContext context = listener.EndGetContext(result);
HttpListenerRequest request = context.Request;
// Obtain a response object.
HttpListenerResponse response = context.Response;
// Construct a response.
string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
// Get a response stream and write the response to it.
response.ContentLength64 = buffer.Length;
System.IO.Stream output = response.OutputStream;
output.Write(buffer,0,buffer.Length);
// You must close the output stream.
output.Close();
}
Public Shared Sub ListenerCallback(ByVal result As IAsyncResult)
Dim listener As HttpListener = CType(result.AsyncState, HttpListener)
' Call EndGetContext to complete the asynchronous operation.
Dim context As HttpListenerContext = listener.EndGetContext(result)
Dim request As HttpListenerRequest = context.Request
' Obtain a response object.
Dim response As HttpListenerResponse = context.Response
' Construct a response.
Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
' Get a response stream and write the response to it.
response.ContentLength64 = buffer.Length
Dim output As System.IO.Stream = response.OutputStream
output.Write(buffer, 0, buffer.Length)
' You must close the output stream.
output.Close()
End Sub
Hinweise
Die BeginGetContext Methode beginnt einen asynchronen (nicht blockierenden) Aufruf zum Empfangen eingehender Clientanforderungen. Bevor Sie diese Methode aufrufen, müssen Sie die Start Methode aufrufen und mindestens ein URI-Präfix (Uniform Resource Identifier) hinzufügen, um zu überwachen, indem Sie die URI-Zeichenfolgen zur HttpListenerPrefixCollection von der Prefixes Eigenschaft zurückgegebenen hinzufügen.
Der asynchrone Vorgang muss durch Aufrufen der EndGetContext Methode abgeschlossen werden. In der callback Regel wird die Methode vom Delegaten aufgerufen.
Diese Methode blockiert nicht, während der Vorgang abgeschlossen ist. Rufen Sie die GetContext Methode auf, um eine eingehende Anforderung abzurufen und zu blockieren, bis der Vorgang abgeschlossen ist.
Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter asynchrones Aufrufen synchroner Methoden.
Hinweise für Aufrufer
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.
