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
パラメーター
- prefix
- String
WebRequest 子孫サービスの完全な URI または URI プレフィックス。
- creator
- IWebRequestCreate
WebRequest の子孫を作成するために WebRequest が呼び出す create メソッド。
戻り値
登録が成功した場合の true
;それ以外の場合は、false
します。
例外
注釈
注意
WebRequest
、HttpWebRequest
、ServicePoint
、WebClient
は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。
RegisterPrefix メソッドは、WebRequest 子孫をサービス要求に登録します。 WebRequest 子孫は通常、HTTP や FTP などの特定のプロトコルを処理するように登録されますが、サーバー上の特定のサーバーまたはパスへの要求を処理するように登録できます。
既に登録されている事前登録済みの予約の種類は次のとおりです。
http://
https://
ftp://
file://
詳細については、Create(String) および Create(Uri) メソッドを参照してください。
重複するプレフィックスは使用できません。
RegisterPrefix は、重複するプレフィックスを登録しようとした場合に false
を返します。
手記
HttpWebRequest クラスは、既定で HTTP スキームと HTTPS スキームのサービス要求に登録されます。 これらのスキームに対して別の WebRequest 子孫を登録しようとすると失敗します。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示