WebRequest.RegisterPrefix(String, IWebRequestCreate) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

WebRequest 子系服務的完整 URI 或 URI 前置詞。

WebRequest 呼叫以建立 WebRequest 子代的 create 方法。

Boolean

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

prefix null

-或-

creator null。

謹慎

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

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

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

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

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

注意

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