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

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した 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

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

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

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

prefix は null です

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

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

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

重複するプレフィックスは許可されません。 RegisterPrefix は、 false 重複するプレフィックスの登録が試行された場合に返されます。

注意

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