HttpListener.Prefixes Property

Gets the Uniform Resource Identifier (URI) prefixes handled by this HttpListener object.

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

public HttpListenerPrefixCollection Prefixes { get; }

Property Value

Type: System.Net.HttpListenerPrefixCollection
An HttpListenerPrefixCollection that contains the URI prefixes that this HttpListener object is configured to handle.

ExceptionCondition
ObjectDisposedException

This object has been closed.

The prefixes are in canonical form. For a detailed description of prefixes, see the HttpListener class overview.

The following code example demonstrates using the Prefixes property to obtain and print the URI prefixes that are handled.

public static void DisplayPrefixesAndState(HttpListener listener)
{
    // List the prefixes to which the server listens.
    HttpListenerPrefixCollection prefixes = listener.Prefixes;
    if (prefixes.Count == 0)
    {
        Console.WriteLine("There are no prefixes.");
    }
    foreach(string prefix in prefixes)
    {
        Console.WriteLine(prefix);
    }
    // Show the listening state. 
    if (listener.IsListening)
    {
        Console.WriteLine("The server is listening.");
    }
}

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft