WebRequest.RegisterPrefix(String, IWebRequestCreate) 方法

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

WebRequest.cs

為指定的 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 方法。

傳回

Boolean

如果註冊成功，true;否則，false。

例外狀況

ArgumentNullException

prefixnull

-或-

creatornull。

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

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

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

• http://

• https://

• ftp://

• file://

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

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

注意

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