WebRequest クラス

リファレンス

定義

名前空間:: System.Net

アセンブリ:: System.Net.Requests.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

ソース:: WebRequest.cs

ソース:: WebRequest.cs

ソース:: WebRequest.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Uri (Uniform Resource Identifier) に対して要求を行います。これは abstract クラスです。

public ref class WebRequest abstract

public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable

public abstract class WebRequest

public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

[System.Serializable]
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

type WebRequest = class

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

[<System.Serializable>]
type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

継承: Object
WebRequest

継承: Object

MarshalByRefObject
WebRequest

派生: System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

属性: SerializableAttribute

実装: ISerializable

例

次の例は、WebRequest インスタンスを作成し、応答を返す方法を示しています。

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Text;
int main()
{
   
   // Create a request for the URL.   
   WebRequest^ request = WebRequest::Create( "http://www.contoso.com/default.html" );
   
   // If required by the server, set the credentials.
   request->Credentials = CredentialCache::DefaultCredentials;
   
   // Get the response.
   HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
   
   // Display the status.
   Console::WriteLine( response->StatusDescription );
   
   // Get the stream containing content returned by the server.
   Stream^ dataStream = response->GetResponseStream();
   
   // Open the stream using a StreamReader for easy access.
   StreamReader^ reader = gcnew StreamReader( dataStream );
   
   // Read the content.
   String^ responseFromServer = reader->ReadToEnd();
   
   // Display the content.
   Console::WriteLine( responseFromServer );
   
   // Cleanup the streams and the response.
   reader->Close();
   dataStream->Close();
   response->Close();
}

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Examples.System.Net
{
    public class WebRequestGetExample
    {
        public static void Main ()
        {
            // Create a request for the URL. 		
            WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
            // If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials;
            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
            // Display the status.
            Console.WriteLine (response.StatusDescription);
            // Get the stream containing content returned by the server.
            Stream dataStream = response.GetResponseStream ();
            // Open the stream using a StreamReader for easy access.
            StreamReader reader = new StreamReader (dataStream);
            // Read the content.
            string responseFromServer = reader.ReadToEnd ();
            // Display the content.
            Console.WriteLine (responseFromServer);
            // Cleanup the streams and the response.
            reader.Close ();
            dataStream.Close ();
            response.Close ();
        }
    }
}

Imports System.IO
Imports System.Net
Imports System.Text

Namespace Examples.System.Net
    Public Class WebRequestGetExample

        Public Shared Sub Main()
            ' Create a request for the URL. 		
            Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
            ' If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials
            ' Get the response.
            Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
            ' Display the status.
            Console.WriteLine(response.StatusDescription)
            ' Get the stream containing content returned by the server.
            Dim dataStream As Stream = response.GetResponseStream()
            ' Open the stream using a StreamReader for easy access.
            Dim reader As New StreamReader(dataStream)
            ' Read the content.
            Dim responseFromServer As String = reader.ReadToEnd()
            ' Display the content.
            Console.WriteLine(responseFromServer)
            ' Cleanup the streams and the response.
            reader.Close()
            dataStream.Close()
            response.Close()
        End Sub
    End Class
End Namespace

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

WebRequest は、.の abstract 基底クラスです。インターネットからデータにアクセスするための NET の要求/応答モデル。要求/応答モデルを使用するアプリケーションは、プロトコルに依存しない方法でインターネットからデータを要求できます。この方法では、アプリケーションは WebRequest クラスのインスタンスと連携し、プロトコル固有の子孫クラスは要求の詳細を実行します。

要求は、アプリケーションから特定の URI (サーバー上の Web ページなど) に送信されます。 URI は、アプリケーションに登録されている WebRequest 子孫の一覧から作成する適切な子孫クラスを決定します。 WebRequest 子孫は通常、HTTP や FTP などの特定のプロトコルを処理するために登録されますが、サーバー上の特定のサーバーまたはパスへの要求を処理するように登録できます。

WebRequest クラスは、インターネットリソースへのアクセス中にエラーが発生したときに WebException をスローします。 Status プロパティは、エラーの原因を示す WebExceptionStatus 値の 1 つです。 Status が WebExceptionStatus.ProtocolErrorされている場合、Response プロパティにはインターネットリソースから受信した WebResponse が含まれます。

WebRequest クラスは abstract クラスであるため、実行時の WebRequest インスタンスの実際の動作は、Create メソッドによって返される子孫クラスによって決まります。既定値と例外の詳細については、HttpWebRequest や FileWebRequestなどの子孫クラスのドキュメントを参照してください。

手記

Create メソッドを使用して、新しい WebRequest インスタンスを初期化します。 WebRequest コンストラクターは使用しないでください。

手記

WebRequest オブジェクトを作成するアプリケーションが Normal ユーザーの資格情報を使用して実行される場合、アプリケーションはローカルコンピューターストアにインストールされている証明書にアクセスできません。ただし、そのアクセス許可がユーザーに明示的に付与されていない限り、アプリケーションはアクセスできません。

注意 (実装者)

WebRequestから継承する場合は、Method、RequestUri、Headers、ContentLength、ContentType、Credentials、PreAuthenticate、GetRequestStream()、BeginGetRequestStream(AsyncCallback, Object)、EndGetRequestStream(IAsyncResult)、GetResponse()、BeginGetResponse(AsyncCallback, Object)、および EndGetResponse(IAsyncResult)のメンバーをオーバーライドする必要があります。さらに、Create(Uri)を呼び出すときに使用する Create(Uri) メソッドを定義する IWebRequestCreate インターフェイスの実装を指定する必要があります。 RegisterPrefix(String, IWebRequestCreate) メソッドまたは構成ファイルを使用して、IWebRequestCreate インターフェイスを実装するクラスを登録する必要があります。

コンストラクター

WebRequest()	古い. WebRequest クラスの新しいインスタンスを初期化します。
WebRequest(SerializationInfo, StreamingContext)	古い. SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、WebRequest クラスの新しいインスタンスを初期化します。

プロパティ

AuthenticationLevel	この要求に使用される認証と偽装のレベルを示す値を取得または設定します。
CachePolicy	この要求のキャッシュポリシーを取得または設定します。
ConnectionGroupName	子孫クラスでオーバーライドされると、要求の接続グループの名前を取得または設定します。
ContentLength	子孫クラスでオーバーライドされると、送信される要求データのコンテンツ長を取得または設定します。
ContentType	子孫クラスでオーバーライドされると、送信される要求データのコンテンツタイプを取得または設定します。
CreatorInstance	古い. 子孫クラスでオーバーライドされると、指定した URI への要求を行うためにインスタンス化された WebRequest を作成するために使用される IWebRequestCreate クラスから派生したファクトリオブジェクトを取得します。
Credentials	子孫クラスでオーバーライドされると、インターネットリソースで要求を認証するために使用されるネットワーク資格情報を取得または設定します。
DefaultCachePolicy	この要求の既定のキャッシュポリシーを取得または設定します。
DefaultWebProxy	グローバル HTTP プロキシを取得または設定します。
Headers	子孫クラスでオーバーライドされると、要求に関連付けられているヘッダー名と値のペアのコレクションを取得または設定します。
ImpersonationLevel	現在の要求の偽装レベルを取得または設定します。
Method	子孫クラスでオーバーライドされると、この要求で使用するプロトコルメソッドを取得または設定します。
PreAuthenticate	子孫クラスでオーバーライドされた場合、要求を事前認証するかどうかを示します。
Proxy	子孫クラスでオーバーライドされると、このインターネットリソースへのアクセスに使用するネットワークプロキシを取得または設定します。
RequestUri	子孫クラスでオーバーライドされると、要求に関連付けられているインターネットリソースの URI を取得します。
Timeout	要求がタイムアウトするまでの時間の長さをミリ秒単位で取得または設定します。
UseDefaultCredentials	子孫クラスでオーバーライドされると、DefaultCredentials が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。

メソッド

Abort()	要求を中止します。
BeginGetRequestStream(AsyncCallback, Object)	子孫クラスでオーバーライドされると、GetRequestStream() メソッドの非同期バージョンが提供されます。
BeginGetResponse(AsyncCallback, Object)	子孫クラスでオーバーライドされると、インターネットリソースの非同期要求を開始します。
Create(String)	古い. 指定した URI スキームの新しい WebRequest インスタンスを初期化します。
Create(Uri)	古い. 指定した URI スキームの新しい WebRequest インスタンスを初期化します。
CreateDefault(Uri)	古い. 指定した URI スキームの新しい WebRequest インスタンスを初期化します。
CreateHttp(String)	古い. 指定した URI 文字列の新しい HttpWebRequest インスタンスを初期化します。
CreateHttp(Uri)	古い. 指定した URI の新しい HttpWebRequest インスタンスを初期化します。
CreateObjRef(Type)	リモートオブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	子孫クラスでオーバーライドされると、インターネットリソースにデータを書き込むための Stream を返します。
EndGetResponse(IAsyncResult)	子孫クラスでオーバーライドされると、WebResponseを返します。
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	古い. ターゲットオブジェクトをシリアル化するために必要なデータを SerializationInfo に設定します。
GetRequestStream()	子孫クラスでオーバーライドされると、インターネットリソースにデータを書き込むための Stream を返します。
GetRequestStreamAsync()	子孫クラスでオーバーライドされると、非同期操作としてインターネットリソースにデータを書き込むための Stream を返します。
GetResponse()	子孫クラスでオーバーライドされると、インターネット要求への応答を返します。
GetResponseAsync()	子孫クラスでオーバーライドされると、インターネット要求への応答を非同期操作として返します。
GetSystemWebProxy()	現在偽装されているユーザーのインターネットオプション設定で構成されたプロキシを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
RegisterPortableWebRequestCreator(IWebRequestCreate)	古い. IWebRequestCreate オブジェクトを登録します。
RegisterPrefix(String, IWebRequestCreate)	指定した URI の WebRequest 子孫を登録します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

古い.

子孫クラスでオーバーライドされると、WebRequestのシリアル化に必要なデータを SerializationInfo インスタンスに設定します。

適用対象

次の方法で共有