WebRequest.RegisterPrefix(String, IWebRequestCreate) Método

Definición

Registra un WebRequest descendiente para el 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

Prefijo completo de URI o URI que los WebRequest servicios descendientes.

creator
IWebRequestCreate

Método create que WebRequest llama a para crear el WebRequest descendiente.

Devoluciones

true si el registro es correcto; de lo contrario, false.

Excepciones

prefix es null.

O bien

creator es null.

Comentarios

Caution

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Utilice HttpClient en su lugar.

El RegisterPrefix método registra descendientes WebRequest en las solicitudes de servicio. WebRequest Los descendientes normalmente se registran para controlar un protocolo específico, como HTTP o FTP, pero se pueden registrar para controlar una solicitud a un servidor específico o ruta de acceso en un servidor.

Los tipos de reserva previamente registrados ya registrados incluyen lo siguiente:

  • http://

  • https://

  • ftp://

  • file://

Para obtener más información, consulte los Create(String) métodos y Create(Uri) .

No se permiten prefijos duplicados. RegisterPrefix devuelve false si se intenta registrar un prefijo duplicado.

Note

La HttpWebRequest clase se registra en solicitudes de servicio para esquemas HTTP y HTTPS de forma predeterminada. Se producirá un error en los intentos de registrar un descendiente diferente WebRequest para estos esquemas.

Se aplica a