語言

WebRequest.RegisterPrefix(String, IWebRequestCreate) 方法

定義

註冊 WebRequest 指定 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

完整的 URI 或後代所服務的 URI 前綴 WebRequest 。

creator
IWebRequestCreate

創建方法,呼叫 WebRequest 來創造 WebRequest 後代。

傳回

true若註冊成功;否則,。 false

例外狀況

prefix 是 null

-或-

creator 是 null。

備註

注意事項

WebRequest、、HttpWebRequest、ServicePointWebClient、和 都已過時,你不應該用它們來做新開發。 請改用 HttpClient。

此 RegisterPrefix 方法會 WebRequest 註冊服務請求的後代。 WebRequest 後代通常註冊以處理特定協定,如 HTTP 或 FTP,但也可註冊以處理對特定伺服器或伺服器路徑的請求。

已登記的預登記儲備類型包括以下類型:

  • http://

  • https://

  • ftp://

  • file://

欲了解更多資訊,請參閱與Create(String)方法。Create(Uri)

不允許重複前綴。 RegisterPrefix 若嘗試註冊重複前綴,則返回 false 。

Note

該 HttpWebRequest 類別預設註冊用於 HTTP 和 HTTPS 方案的服務請求。 嘗試為這些方案登記其他 WebRequest 後代將失敗。

適用於