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

定義

指定した URI 用の WebRequest 派生クラスを登録します。Registers a WebRequest descendant for the specified URI.

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 プレフィックス。The complete URI or URI prefix that the WebRequest descendant services.

creator
IWebRequestCreate

WebRequestWebRequest 派生クラスを作成するために呼び出す作成メソッド。The create method that the WebRequest calls to create the WebRequest descendant.

戻り値

Boolean

登録が成功した場合は true。それ以外の場合は falsetrue if registration is successful; otherwise, false.

例外

prefixnull ですprefix is null

- または --or- creatornullです。creator is null.

注釈

RegisterPrefixメソッドは、 WebRequest 子孫をサービス要求に登録します。The RegisterPrefix method registers WebRequest descendants to service requests. WebRequest 通常、子孫は、HTTP や FTP などの特定のプロトコルを処理するように登録されますが、サーバー上の特定のサーバーまたはパスへの要求を処理するように登録できます。WebRequest descendants are typically registered to handle a specific protocol, such HTTP or FTP, but can be registered to handle a request to a specific server or path on a server.

登録済みの事前登録済みの予約の種類には、次のものがあります。The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

詳細については、Create(String) メソッドと Create(Uri) メソッドを参照してください。For more information, see the Create(String) and Create(Uri) methods.

重複するプレフィックスは使用できません。Duplicate prefixes are not allowed. RegisterPrefix 重複するプレフィックスを登録しようとした場合は、を返し false ます。RegisterPrefix returns false if an attempt is made to register a duplicate prefix.

注意

クラスは、 HttpWebRequest 既定で HTTP および HTTPS スキームのサービス要求に登録されます。The HttpWebRequest class is registered to service requests for HTTP and HTTPS schemes by default. これらのスキーマに対して異なる子孫を登録しようとすると、 WebRequest 失敗します。Attempts to register a different WebRequest descendant for these schemes will fail.

適用対象