WebRequest.RegisterPrefix(String, IWebRequestCreate) Método

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Registra um descendente de WebRequest 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 o prefixo do URI que o descendente de WebRequest atende.

creator: IWebRequestCreate

O método de criação que o WebRequest chama para criar o descendente de WebRequest.

Retornos

Boolean

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

Exceções

ArgumentNullException

prefix é null

- ou - creator é null.

Comentários

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

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

http://
https://
ftp://
file://

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

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

Observação

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