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

WebRequest の子孫を作成するために WebRequest が呼び出す create メソッド。

戻り値

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

例外

prefixnull

-又は-

creatornullです。

注釈

注意

WebRequestHttpWebRequestServicePointWebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

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

  • http://

  • https://

  • ftp://

  • file://

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

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

手記

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

適用対象