共用方式為


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

例外狀況

prefix null

-或-

creator null

備註

謹慎

WebRequestHttpWebRequestServicePointWebClient 已經過時,您不應該將它們用於新的開發。 請改用 HttpClient

RegisterPrefix 方法會向服務要求註冊 WebRequest 子系。 WebRequest 子系通常會註冊來處理特定通訊協定,例如 HTTP 或 FTP,但可以註冊以處理伺服器上特定伺服器或路徑的要求。

已註冊的預先註冊保留類型包括下列各項:

  • http://

  • https://

  • ftp://

  • file://

如需詳細資訊,請參閱 Create(String)Create(Uri) 方法。

不允許重複的前置詞。 如果嘗試註冊重複的前置詞,RegisterPrefix 會傳回 false

注意

根據預設,HttpWebRequest 類別會註冊至 HTTP 和 HTTPS 配置的服務要求。 嘗試註冊這些配置的不同 WebRequest 子系將會失敗。

適用於