WebRequest.RegisterPrefix(String, IWebRequestCreate) Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

WebRequest.cs

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

Boolean

true si el registro se realiza correctamente; de lo contrario, false.

Excepciones

ArgumentNullException

prefix null

-o-

creator es null.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy 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.