HttpListenerPrefixCollection.Clear メソッド

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

HttpListenerPrefixCollection.Clear メソッド

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

コレクションからすべての URI プレフィックスを削除します。

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

Visual Basic (宣言)

Public Sub Clear

Visual Basic (使用法)

Dim instance As HttpListenerPrefixCollection

instance.Clear

C#

public void Clear ()

C++

public:
virtual void Clear () sealed

J#

public final void Clear ()

JScript

public final function Clear ()

例外

例外の種類	条件
HttpListenerException	Windows 関数呼び出しが失敗しました。例外の ErrorCode プロパティをチェックして、例外の原因を確認してください。
ObjectDisposedException	このコレクションに関連付けられている HttpListener は閉じています。

解説

このメソッドを呼び出した後は、新しいプレフィックスを追加せずに、関連付けられている HttpListener を起動することはできません。この操作を行おうとすると、例外がスローされます。

呼び出し時の注意 このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

HttpListenerPrefixCollection 内のすべてのプレフィックスを削除するコード例を次に示します。

C#

public static bool RemoveAllPrefixes(HttpListener
 listener)
{
    // Get the prefixes that the Web server is listening to.
    HttpListenerPrefixCollection prefixes = listener.Prefixes;
    try 
    {
        prefixes.Clear();
    } 
    // If the operation failed, return false.
    catch
    {
        return false;
    }
    return true;
}

プラットフォーム

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 クラス