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 が呼び出す create メソッド。

Boolean

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

prefix が null

-又は-

creator は nullです。

注意

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

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

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

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

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

手記

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