WebClient.GetWebRequest(Uri) 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

來源:

WebClient.cs

傳回指定資源的 WebRequest 物件。

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

參數

address

Uri

識別要要求之資源的 Uri。

傳回

WebRequest

指定資源的新 WebRequest 物件。

範例

下列程式代碼範例示範這個方法的實作，這個方法可由衍生自 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;
}

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

這個方法會將現有的 Headers、Credentials和 方法複製到新建立的 WebRequest 物件。

這個方法只能由繼承自 WebClient的類別呼叫。 提供它，以提供繼承者存取基礎 WebRequest 物件。 衍生類別應該呼叫 GetWebRequest 的基類實作，以確保方法如預期般運作。