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 -> boolPublic Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As Booleanパラメーター
- prefix
- String
WebRequest子孫サービスの完全な URI または URI プレフィックス。
- creator
- IWebRequestCreate
WebRequestの子孫を作成するためにWebRequestが呼び出す create メソッド。
返品
true 登録が成功した場合。それ以外の場合は false。
例外
注釈
Caution
WebRequest、 HttpWebRequest、 ServicePoint、 WebClient は廃止されており、新しい開発には使用しないでください。
HttpClient を代わりに使用します。
RegisterPrefix メソッドは、WebRequest子孫をサービス要求に登録します。 WebRequest 子孫は通常、HTTP や FTP などの特定のプロトコルを処理するために登録されますが、サーバー上の特定のサーバーまたはパスへの要求を処理するように登録できます。
既に登録されている事前登録済みの予約の種類は次のとおりです。
http://https://ftp://file://
詳細については、 Create(String) および Create(Uri) メソッドを参照してください。
重複するプレフィックスは使用できません。
RegisterPrefix は、重複するプレフィックスを登録しようとした場合に false を返します。
Note
HttpWebRequest クラスは、既定で HTTP スキームと HTTPS スキームのサービス要求に登録されます。 これらのスキームに対して別の WebRequest 子孫を登録しようとすると失敗します。
