WebClient.GetWebRequest(Uri) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Origem:

WebClient.cs

Retorna um objeto WebRequest para o 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

Um Uri que identifica o recurso a ser solicitado.

Retornos

WebRequest

Um novo objeto WebRequest para o recurso especificado.

Exemplos

O exemplo de código a seguir mostra uma implementação desse método que pode ser personalizada por uma classe 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;
}

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Esse método copia o Headersexistente, Credentialse o método para o objeto WebRequest recém-criado.

Esse método só pode ser chamado por classes que herdam de WebClient. Ele é fornecido para conceder aos herdadores acesso ao objeto WebRequest subjacente. Classes derivadas devem chamar a implementação da classe base de GetWebRequest para garantir que o método funcione conforme o esperado.