WebRequest.RegisterPrefix(String, IWebRequestCreate) 方法

  • 参考

定义

命名空间:
System.Net
程序集:
System.Net.Requests.dll
程序集:
System.dll
程序集:
netstandard.dll

为指定的 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 子代。

返回

Boolean

如果注册成功，则为 true；否则为 false。

例外

ArgumentNullException

prefix 为 null

- 或 -

creator 为 null。

注解

方法 RegisterPrefix 将 WebRequest 后代注册到服务请求。 WebRequest 后代通常注册以处理特定协议（如 HTTP 或 FTP），但可以注册以处理对服务器上特定服务器或路径的请求。

已注册的预注册保留类型包括：

  • http://

  • https://

  • ftp://

  • file://

有关详细信息，请参阅 Create(String) 和 Create(Uri) 方法。

不允许重复前缀。 RegisterPrefixfalse如果尝试注册重复前缀，则返回 。

备注

默认情况下，类 HttpWebRequest 注册到 HTTP 和 HTTPS 方案的服务请求。 尝试为这些方案注册不同的 WebRequest 后代将失败。

适用于