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 后代将失败。

适用于