Export (0) Print
Expand All

HttpListener.Stop Method

Note: This method is new in the .NET Framework version 2.0.

Causes this instance to stop receiving incoming requests.

Namespace: System.Net
Assembly: System (in system.dll)

public void Stop ()
public void Stop ()
public function Stop ()

Exception typeCondition

ObjectDisposedException

This object has been closed.

If this instance is already stopped, calling this method has no effect.

After you have stopped an HttpListener object, you can use the Start method to restart it.

Notes to Callers This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

The following code example demonstrates using the Stop method to stop processing incoming requests.


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

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft