WebRequest.RegisterPrefix(String, IWebRequestCreate) Método
Definição
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 -> boolPublic Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As BooleanParâmetros
- prefix
- String
O prefixo URI ou URI completo que o WebRequest serviços descendentes.
- creator
- IWebRequestCreate
O método create que o WebRequest chama para criar o descendente WebRequest.
Retornos
true se o registro for bem-sucedido; caso contrário, false.
Exceções
Comentários
Cuidado
WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.
O método RegisterPrefix registra descendentes WebRequest para solicitações de serviço. WebRequest 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 Create(String) e Create(Uri).
Prefixos duplicados não são permitidos.
RegisterPrefix retornará false se for feita uma tentativa de registrar um prefixo duplicado.
Nota
A classe HttpWebRequest é registrada para solicitações de serviço para esquemas HTTP e HTTPS por padrão. As tentativas de registrar um descendente de WebRequest diferente para esses esquemas falharão.
