WebClient.GetWebRequest(Uri) Metoda

Definicja

Namespace:

System.Net

Zestawów:

netstandard.dll, System.Net.WebClient.dll

Źródło:

WebClient.cs

Zwraca obiekt WebRequest dla określonego zasobu.

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

Parametry

address

Uri

Uri identyfikujący zasób do żądania.

Zwraca

WebRequest

Nowy obiekt WebRequest dla określonego zasobu.

Przykłady

Poniższy przykład kodu przedstawia implementację tej metody, którą można dostosować za pomocą klasy pochodzącej z 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;
}

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta metoda kopiuje istniejące Headers, Credentialsi metody do nowo utworzonego obiektu WebRequest.

Ta metoda może być wywoływana tylko przez klasy dziedziczone z WebClient. Zapewnia dostęp dziedziczących do bazowego obiektu WebRequest. Klasy pochodne powinny wywoływać implementację klasy bazowej GetWebRequest, aby upewnić się, że metoda działa zgodnie z oczekiwaniami.