WebRequest.RegisterPrefix メソッド

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

WebRequest.RegisterPrefix メソッド

指定した URI 用の WebRequest 派生クラスを登録します。

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

Visual Basic (宣言)

Public Shared Function RegisterPrefix
 ( _
    prefix As String, _
    creator As IWebRequestCreate _
) As Boolean

Visual Basic (使用法)

Dim prefix As String
Dim creator As IWebRequestCreate
Dim returnValue As Boolean

returnValue = WebRequest.RegisterPrefix(prefix, creator)

C#

public static bool RegisterPrefix
 (
    string prefix,
    IWebRequestCreate creator
)

C++

public:
static bool RegisterPrefix (
    String^ prefix, 
    IWebRequestCreate^ creator
)

J#

public static boolean RegisterPrefix (
    String prefix, 
    IWebRequestCreate creator
)

JScript

public static function RegisterPrefix
 (
    prefix : String, 
    creator : IWebRequestCreate
) : boolean

パラメータ

prefix

WebRequest 派生クラスが処理する完全な URI または URI プリフィックス。

creator

WebRequest が WebRequest 派生クラスを作成するために呼び出す作成メソッド。

戻り値
登録が成功した場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	prefix is null 参照 (Visual Basic では Nothing) または creator が null 参照 (Visual Basic では Nothing) です。

解説

RegisterPrefix メソッドは、要求を実行する WebRequest 派生クラスを登録します。通常、WebRequest 派生クラスは、HTTP または FTP などの固有のプロトコルを処理するために登録されていますが、固有なサーバーまたはサーバーのパスへの要求を処理するために登録することもできます。

重複するプリフィックスは使用できません。重複するプリフィックスを登録しようとすると、RegisterPrefix は false を返します。

メモ
既定では、HttpWebRequest クラスは HTTP スキームと HTTPS スキームの要求を実行するために登録されています。これらのスキーム用に異なる WebRequest 派生クラスは登録できません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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