WebRequest.RegisterPrefix(String, IWebRequestCreate) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
註冊 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
例外狀況
備註
注意事項
WebRequest、、HttpWebRequest、ServicePointWebClient、和 都已過時,你不應該用它們來做新開發。 請改用 HttpClient。
此 RegisterPrefix 方法會 WebRequest 註冊服務請求的後代。 WebRequest 後代通常註冊以處理特定協定,如 HTTP 或 FTP,但也可註冊以處理對特定伺服器或伺服器路徑的請求。
已登記的預登記儲備類型包括以下類型:
http://https://ftp://file://
欲了解更多資訊,請參閱與Create(String)方法。Create(Uri)
不允許重複前綴。
RegisterPrefix 若嘗試註冊重複前綴,則返回 false 。
Note
該 HttpWebRequest 類別預設註冊用於 HTTP 和 HTTPS 方案的服務請求。 嘗試為這些方案登記其他 WebRequest 後代將失敗。