WebClient.GetWebRequest(Uri) Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebClient.dll

Source:

WebClient.cs

Devuelve un objeto WebRequest para el recurso especificado.

protected:
 virtual System::Net::WebRequest ^ GetWebRequest(Uri ^ address);

protected virtual System.Net.WebRequest GetWebRequest (Uri address);

abstract member GetWebRequest : Uri -> System.Net.WebRequest
override this.GetWebRequest : Uri -> System.Net.WebRequest

Protected Overridable Function GetWebRequest (address As Uri) As WebRequest

Parámetros

address

Uri

Un Uri que identifica el recurso que se va a solicitar.

Devoluciones

WebRequest

Nuevo objeto WebRequest para el recurso especificado.

Ejemplos

En el ejemplo de código siguiente se muestra una implementación de este método que puede personalizar una clase derivada de WebClient.

virtual WebRequest^ GetWebRequest ( Uri^ address ) override
{
   WebRequest^ request = dynamic_cast<WebRequest^>(WebClient::GetWebRequest( address ));

   // Perform any customizations on the request.
   // This version of WebClient always preauthenticates.
   request->PreAuthenticate = true;
   return request;
}

protected override WebRequest GetWebRequest (Uri address)
{
    WebRequest request = (WebRequest) base.GetWebRequest (address);

    // Perform any customizations on the request.
    // This version of WebClient always preauthenticates.
    request.PreAuthenticate = true;
    return request;
}

Comentarios

Cautela

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

Este método copia el Headersexistente, Credentialsy el método en el objeto WebRequest recién creado.

Las clases que heredan de WebClientsolo puede llamar a este método . Se proporciona para conceder acceso a los heredadores al objeto WebRequest subyacente. Las clases derivadas deben llamar a la implementación de clase base de GetWebRequest para asegurarse de que el método funciona según lo previsto.