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
参数
- prefix
- String
WebRequest 后代服务的完整 URI 或 URI 前缀。
- creator
- IWebRequestCreate
WebRequest 调用创建 WebRequest 后代的 create 方法。
返回
如果注册成功,true
;否则,false
。
例外
注解
谨慎
WebRequest
、HttpWebRequest
、ServicePoint
和 WebClient
已过时,不应将其用于新开发。 请改用 HttpClient。
RegisterPrefix 方法向服务请求注册 WebRequest 后代。 WebRequest 后代通常注册为处理特定协议(例如 HTTP 或 FTP),但可以注册以处理对服务器上的特定服务器或路径的请求。
已注册的预留类型包括:
http://
https://
ftp://
file://
有关详细信息,请参阅 Create(String) 和 Create(Uri) 方法。
不允许重复前缀。 如果尝试注册重复前缀,RegisterPrefix 将返回 false
。
注意
默认情况下,HttpWebRequest 类注册到 HTTP 和 HTTPS 方案的服务请求。 尝试注册这些方案的不同 WebRequest 后代将失败。