WebClient.GetWebRequest(Uri) メソッド

定義

指定したリソースの WebRequest オブジェクトを返します。Returns a WebRequest object for the specified resource.

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

要求するリソースを識別する UriA Uri that identifies the resource to request.

戻り値

WebRequest

指定したリソースの新しい WebRequest オブジェクト。A new WebRequest object for the specified resource.

次のコード例は、から派生したクラスによってカスタマイズできる、このメソッドの実装を示して WebClient います。The following code example shows an implementation of this method that can be customized by a class derived from 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;
}

注釈

このメソッドは、既存の HeadersCredentials 、およびメソッドを新しく作成されたオブジェクトにコピーし WebRequest ます。This method copies the existing Headers, Credentials, and method to the newly created WebRequest object.

このメソッドは、から継承するクラスによってのみ呼び出すことができ WebClient ます。This method can be called only by classes that inherit from WebClient. これは、継承元が基になるオブジェクトにアクセスできるようにするために用意されてい WebRequest ます。It is provided to give inheritors access to the underlying WebRequest object. 派生クラスは、 GetWebRequest メソッドが期待どおりに動作することを保証するために、の基本クラスの実装を呼び出す必要があります。Derived classes should call the base class implementation of GetWebRequest to ensure the method works as expected.

適用対象