Export (0) Print
Expand All

HttpListenerPrefixCollection.GetEnumerator Method

Returns an object that can be used to iterate through the collection.

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

public IEnumerator<string> GetEnumerator ()
public final IEnumerator<String> GetEnumerator ()
public final function GetEnumerator () : IEnumerator<String>
Not applicable.

Return Value

An object that implements the IEnumerator interface and provides access to the strings in this collection.

The object that is returned by this method is initially positioned before the first element in this collection. You must call the MoveNext method before you can access the first element. To access the element at the current position, call the Current property.

Do not modify the collection while using the enumerator. If the collection is modified while an enumerator is in use, an attempt to set the position by calling MoveNext or Reset causes an InvalidOperationException.

For a detailed description of enumerators, see the documentation for the IEnumerator class and the GetEnumerator method.

The following code example demonstrates enumerating through a collection. Note that the Visual Basic and C# examples use language specific statements to enumerate through the collection instead of retrieving the enumerator.

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.");
    }
}

public static void DisplayPrefixesAndState(HttpListener listener)
{
    // List the prefixes to which the server listens.
    HttpListenerPrefixCollection prefixes = listener.get_Prefixes();
    if (prefixes.get_Count() == 0) {
        Console.WriteLine("There are no prefixes.");
    }

    IEnumerator objEnum = prefixes.GetEnumerator();
    String prefix;
    while (objEnum.MoveNext()) {
        prefix = objEnum.get_Current().ToString();
        Console.WriteLine(prefix);
    }
    // Show the listening state.
    if (listener.get_IsListening()) {
        Console.WriteLine("The server is listening.");
    }
} //DisplayPrefixesAndState

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft