WebRequest.RegisterPrefix(String, IWebRequestCreate) Método

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Net.Requests.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Regista um WebRequest descendente para o URI especificado.

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

Parâmetros

prefix
String

O URI completo ou prefixo URI que o WebRequest descendente serve.

creator
IWebRequestCreate

O método criar que chama WebRequest para criar o WebRequest descendente.

Devoluções

Boolean

true se o registo for bem-sucedido; caso contrário, false.

Exceções

ArgumentNullException

prefix é null

-ou-

creator é null.

Observações

Atenção

WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.

O RegisterPrefix método regista WebRequest descendentes para pedidos de serviço. WebRequest os descendentes são normalmente registados para lidar com um protocolo específico, como HTTP ou FTP, mas podem ser registados para tratar um pedido para um servidor ou caminho específico num servidor.

Os tipos de reserva pré-registados já registados incluem os seguintes:

  • http://

  • https://

  • ftp://

  • file://

Para mais informações, consulte o Create(String) e Create(Uri) métodos.

Prefixos duplicados não são permitidos. RegisterPrefix retorna false se for feita uma tentativa de registar um prefixo duplicado.

Note

A HttpWebRequest classe está registada por defeito para pedidos de serviço dos esquemas HTTP e HTTPS. As tentativas de registar um descendente diferente WebRequest para estes esquemas falharão.

Aplica-se a