WebRequest.RegisterPrefix(String, IWebRequestCreate) WebRequest.RegisterPrefix(String, IWebRequestCreate) WebRequest.RegisterPrefix(String, IWebRequestCreate) WebRequest.RegisterPrefix(String, IWebRequestCreate) Method

定義

指定した 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 String String String

WebRequest 派生クラスが処理する完全な URI または URI プリフィックス。The complete URI or URI prefix that the WebRequest descendant services.

creator
IWebRequestCreate IWebRequestCreate IWebRequestCreate IWebRequestCreate

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

戻り値

登録が成功した場合は 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.

適用対象