WebRequest.RegisterPrefix(String, IWebRequestCreate) メソッド

定義

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

public:
 static bool RegisterPrefix(System::String ^ prefix, System::Net::IWebRequestCreate ^ creator);
public static bool RegisterPrefix (string prefix, System.Net.IWebRequestCreate creator);
static member RegisterPrefix : string * System.Net.IWebRequestCreate -> bool
Public Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As Boolean

パラメーター

prefix
String

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

creator
IWebRequestCreate

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

戻り値

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

例外

prefixnull です

- または -

creatornullです。

注釈

メソッドは RegisterPrefix 、子孫を WebRequest サービス要求に登録します。 WebRequest 子孫は通常、HTTP や FTP などの特定のプロトコルを処理するために登録されますが、サーバー上の特定のサーバーまたはパスへの要求を処理するために登録できます。

既に登録されている事前登録済みの予約の種類は次のとおりです。

  • http://

  • https://

  • ftp://

  • file://

詳細については、Create(String) メソッドと Create(Uri) メソッドを参照してください。

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

Note

クラスは HttpWebRequest 、既定で HTTP スキームと HTTPS スキームのサービス要求に登録されます。 これらのスキームに対して別 WebRequest の子孫を登録しようとすると失敗します。

適用対象