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 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
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.