WebRequest.RegisterPrefix(String, IWebRequestCreate) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 WebRequest servicios descendientes.
- creator
- IWebRequestCreate
Método create al que llama el WebRequest para crear el WebRequest descendiente.
Devoluciones
true
si el registro se realiza correctamente; de lo contrario, false
.
Excepciones
Comentarios
Cautela
WebRequest
, HttpWebRequest
, ServicePoint
y WebClient
están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.
El método RegisterPrefix registra WebRequest descendientes en las solicitudes de servicio. WebRequest 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 métodos Create(String) y Create(Uri).
No se permiten prefijos duplicados.
RegisterPrefix devuelve false
si se intenta registrar un prefijo duplicado.
Nota
La clase HttpWebRequest se registra en solicitudes de servicio para esquemas HTTP y HTTPS de forma predeterminada. Se producirá un error en los intentos de registrar otro WebRequest descendiente para estos esquemas.