WebRequest.RegisterPrefix メソッド
指定した URI 用の WebRequest 派生クラスを登録します。
Public Shared Function RegisterPrefix( _
ByVal prefix As String, _ ByVal creator As IWebRequestCreate _) As Boolean
[C#]
public static bool RegisterPrefix(stringprefix,IWebRequestCreatecreator);
[C++]
public: static bool 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 が null 参照 (Visual Basic では Nothing) です。
または creator が null 参照 (Nothing) です。 |
解説
RegisterPrefix メソッドは、要求を実行する WebRequest 派生クラスを登録します。通常、 WebRequest 派生クラスは、HTTP または FTP などの固有のプロトコルを処理するために登録されていますが、固有なサーバーまたはサーバーのパスへの要求を処理するために登録することもできます。
重複するプリフィックスは使用できません。重複するプリフィックスを登録しようとすると、 RegisterPrefix は false を返します。
メモ 既定では、 HttpWebRequest クラスは HTTP スキームと HTTPS スキームの要求を実行するために登録されています。これらのスキーム用に異なる WebRequest 派生クラスは登録できません。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard