WebClient.GetWebRequest(Uri) 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

Source:

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 的基类实现，以确保该方法按预期工作。