HttpListenerPrefixCollection.GetEnumerator メソッド

.NET Framework クラス ライブラリ リファレンス

HttpListenerPrefixCollection.GetEnumerator メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コレクションを反復処理するために使用できるオブジェクトを返します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function GetEnumerator As
 IEnumerator(Of String)

Visual Basic (使用法)

Dim instance As HttpListenerPrefixCollection
Dim returnValue As IEnumerator(Of
 String)

returnValue = instance.GetEnumerator

C#

public IEnumerator<string> GetEnumerator
 ()

C++

public:
virtual IEnumerator<String^>^ GetEnumerator () sealed

J#

public final IEnumerator<String> GetEnumerator ()

JScript

public final function GetEnumerator () : IEnumerator<String>

戻り値
IEnumerator インターフェイスを実装し、このコレクション内の文字列にアクセスできるようにするオブジェクト。

解説

このメソッドが返すオブジェクトは、初期状態ではこのコレクション内の最初の要素の前に配置されます。最初の要素にアクセスするには、MoveNext メソッドを呼び出す必要があります。現在の位置にある要素にアクセスするには、Current プロパティを呼び出します。

列挙子の使用時は、コレクションを変更しないでください。列挙子の使用時にコレクションを変更した場合、MoveNext または Reset を呼び出して位置を設定しようとすると InvalidOperationException が発生します。

列挙子の詳細については、IEnumerator クラスおよび GetEnumerator メソッドに関するドキュメントを参照してください。

使用例

コレクションを列挙処理するコード例を次に示します。Visual Basic の例と C# の例では、列挙子を取得する代わりに、コレクションを列挙処理するための言語固有のステートメントを使用します。

C#

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

プラットフォーム

Windows 98, Windows 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpListenerPrefixCollection クラス
HttpListenerPrefixCollection メンバ
System.Net 名前空間
HttpListener クラス