WebRequest.RegisterPrefix(String, IWebRequestCreate) Método

Definição

Registra 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 prefixo URI ou URI completo que os WebRequest serviços descendentes.

creator
IWebRequestCreate

O método create que as WebRequest chamadas para criar o WebRequest descendente.

Retornos

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

Exceções

prefix é null

- ou -

creator é null.

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

O RegisterPrefix método registra descendentes WebRequest para solicitações de serviço. WebRequest os descendentes normalmente são registrados para lidar com um protocolo específico, como HTTP ou FTP, mas podem ser registrados para lidar com uma solicitação para um servidor ou caminho específico em um servidor.

Os tipos de reserva pré-registrados incluem o seguinte:

  • http://

  • https://

  • ftp://

  • file://

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

Prefixos duplicados não são permitidos. RegisterPrefix retornará false se for feita uma tentativa de registrar um prefixo duplicado.

Note

A HttpWebRequest classe é registrada para solicitações de serviço para esquemas HTTP e HTTPS por padrão. As tentativas de registrar um descendente diferente WebRequest para esses esquemas falharão.

Aplica-se a