HttpListener.Start Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.HttpListener.dll

Source:

HttpListener.Managed.cs

Permet à cette instance de recevoir des demandes entrantes.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Exceptions

HttpListenerException

Un appel de fonction Win32 a échoué. Vérifiez la propriété ErrorCode de l’exception pour déterminer la cause de l’exception.

ObjectDisposedException

Cet objet est fermé.

Exemples

L’exemple de code suivant illustre l’utilisation de la Start méthode pour commencer à traiter les requêtes entrantes.

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

Remarques

Cette méthode doit être appelée avant d’appeler la GetContext méthode ou BeginGetContext .

Une fois que vous avez démarré un HttpListener objet, vous pouvez utiliser la Stop méthode pour l’arrêter.

Notes

Si cette instance d’écouteur utilise https, vous devez installer et sélectionner un certificat de serveur. Sinon, une HttpWebRequest requête de ce HttpListener type échoue avec une fermeture inattendue de la connexion. Vous pouvez configurer des certificats de serveur et d’autres options d’écouteur à l’aide deHttpCfg.exe.

Notes pour les appelants

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.