WebRequestとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebRequest クラス

URI (Uniform Resource Identifier) への要求を行います。これは abstract クラスです。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public MustInherit Class
 WebRequest
    Inherits MarshalByRefObject
    Implements ISerializable

Visual Basic (使用法)

Dim instance As WebRequest

[SerializableAttribute] 
public abstract class WebRequest : MarshalByRefObject,
 ISerializable

C++

[SerializableAttribute] 
public ref class WebRequest abstract : public
 MarshalByRefObject, ISerializable

/** @attribute SerializableAttribute() */ 
public abstract class WebRequest extends MarshalByRefObject
 implements ISerializable

JScript

SerializableAttribute 
public abstract class WebRequest extends
 MarshalByRefObject implements ISerializable

解説

WebRequest は、インターネットからのデータにアクセスするための .NET Framework の要求/応答モデル用の abstract 基本クラスです。要求/応答モデルを使用するアプリケーションは、プロトコルに寛容な方法で、インターネットからデータを要求できます。この場合、アプリケーションは WebRequest クラスのインスタンスで動作し、プロトコルに固有な派生クラスが要求の詳細を実行します。

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

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

WebRequest クラスは abstract クラスであるため、実行時の WebRequest インスタンスの実際の動作は、System.Net.WebRequest.Create メソッドで返される派生クラスによって決まります。既定値および例外の詳細については、HttpWebRequest や FileWebRequest などの派生クラスの説明を参照してください。

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

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

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

使用例

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

Visual Basic

Imports System
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 'Main
    End Class 'WebRequestGetExample
End Namespace

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 ();
        }
    }
}

C++

#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();
}

.NET Framework のセキュリティ

WebPermission (要求された URI またはその要求のリダイレクト先の URI にアクセスするために必要なアクセス許可)Connect (関連する列挙体)

継承階層

System.Object
   System.MarshalByRefObject
    System.Net.WebRequest
       System.Net.FileWebRequest
       System.Net.FtpWebRequest
       System.Net.HttpWebRequest

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebRequest メンバ
System.Net 名前空間
HttpWebRequest クラス
その他の技術情報
データの要求
プラグ可能なプロトコルのプログラミング
プラグ可能なプロトコルのプログラミング

WebRequest コンストラクタ ()

WebRequest クラスの新しいインスタンスを初期化します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New WebRequest

protected WebRequest ()

C++

protected:
WebRequest ()

protected WebRequest ()

JScript

protected function WebRequest ()

解説

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

使用例

WebRequest クラスで Create メソッドを呼び出して、WebRequest インスタンスを作成する方法を次の例に示します。

Visual Basic

Dim myRequest As WebRequest = WebRequest.Create("http://www.contoso.com")

WebRequest myRequest = WebRequest.Create("http://www.contoso.com");

C++

WebRequest^ myRequest = WebRequest::Create( "http://www.contoso.com"
 );

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebRequest クラス
WebRequest メンバ
System.Net 名前空間

WebRequest コンストラクタ (SerializationInfo, StreamingContext)

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

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    serializationInfo As SerializationInfo, _
    streamingContext As StreamingContext _
)

Visual Basic (使用法)

Dim serializationInfo As SerializationInfo
Dim streamingContext As StreamingContext

Dim instance As New WebRequest(serializationInfo,
 streamingContext)

protected WebRequest (
    SerializationInfo serializationInfo,
    StreamingContext streamingContext
)

C++

protected:
WebRequest (
    SerializationInfo^ serializationInfo, 
    StreamingContext streamingContext
)

protected WebRequest (
    SerializationInfo serializationInfo, 
    StreamingContext streamingContext
)

JScript

protected function WebRequest (
    serializationInfo : SerializationInfo, 
    streamingContext : StreamingContext
)

パラメータ

serializationInfo: 新しい WebRequest インスタンスをシリアル化するために必要な情報を格納する SerializationInfo。

streamingContext: 新しい WebRequest インスタンスに関連付けられているシリアル化ストリームのソースを示す StreamingContext。

例外

例外の種類	条件
NotImplementedException	コンストラクタが派生クラスでオーバーライドされていないのに、そのコンストラクタへのアクセスが試行されました。

解説

派生クラスによって実装されると、このコンストラクタは WebRequest 派生クラスの ISerializable インターフェイスを実装します。

シリアル化を使用する場合、アプリケーションは完全信頼モードで実行する必要があります。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WebRequest クラス
WebRequest メンバ
System.Net 名前空間
その他の技術情報
XML シリアル化および SOAP シリアル化

WebRequest コンストラクタ

WebRequest クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
WebRequest ()	WebRequest クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
WebRequest (SerializationInfo, StreamingContext)	SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、WebRequest クラスの新しいインスタンスを初期化します。

参照

WebRequest プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	ImpersonationLevel	現在の要求に対する偽装レベルを取得または設定します。
	UseDefaultCredentials	派生クラスでオーバーライドされる場合、DefaultCredentials が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。

参照

その他の技術情報

データの要求
プラグ可能なプロトコルのプログラミング
プラグ可能なプロトコルのプログラミング

WebRequest メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Abort	要求を中止します。
	BeginGetRequestStream	派生クラスでオーバーライドされると、GetRequestStream メソッドの非同期バージョンを提供します。
	BeginGetResponse	派生クラスでオーバーライドされると、インターネットリソースの非同期要求を開始します。
	Create	オーバーロードされます。新しい WebRequest を初期化します。
	CreateDefault	指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	EndGetRequestStream	派生クラスでオーバーライドされると、インターネットリソースにデータを書き込むための Stream を返します。
	EndGetResponse	派生クラスでオーバーライドされると、WebResponse を返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetRequestStream	派生クラスでオーバーライドされると、インターネットリソースにデータを書き込むための Stream を返します。
	GetResponse	派生クラスでオーバーライドされると、インターネット要求への応答を返します。
	GetSystemWebProxy	現在の偽装ユーザーの Internet Explorer の設定で構成されたプロキシを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RegisterPrefix	指定した URI 用の WebRequest 派生クラスを登録します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetObjectData	SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

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

	名前	説明
	System.Runtime.Serialization.ISerializable.GetObjectData	派生クラスでオーバーライドされる場合、SerializationInfo インスタンスに、WebRequest をシリアル化するために必要なデータを設定します。

参照

その他の技術情報

データの要求
プラグ可能なプロトコルのプログラミング
プラグ可能なプロトコルのプログラミング

WebRequest メンバ

URI (Uniform Resource Identifier) への要求を行います。これは abstract クラスです。

WebRequest データ型で公開されるメンバを以下の表に示します。

プロテクトコンストラクタ

	名前	説明
	WebRequest	オーバーロードされます。 WebRequest クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	ImpersonationLevel	現在の要求に対する偽装レベルを取得または設定します。
	UseDefaultCredentials	派生クラスでオーバーライドされる場合、DefaultCredentials が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Abort	要求を中止します。
	BeginGetRequestStream	派生クラスでオーバーライドされると、GetRequestStream メソッドの非同期バージョンを提供します。
	BeginGetResponse	派生クラスでオーバーライドされると、インターネットリソースの非同期要求を開始します。
	Create	オーバーロードされます。新しい WebRequest を初期化します。
	CreateDefault	指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	EndGetRequestStream	派生クラスでオーバーライドされると、インターネットリソースにデータを書き込むための Stream を返します。
	EndGetResponse	派生クラスでオーバーライドされると、WebResponse を返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetRequestStream	派生クラスでオーバーライドされると、インターネットリソースにデータを書き込むための Stream を返します。
	GetResponse	派生クラスでオーバーライドされると、インターネット要求への応答を返します。
	GetSystemWebProxy	現在の偽装ユーザーの Internet Explorer の設定で構成されたプロキシを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RegisterPrefix	指定した URI 用の WebRequest 派生クラスを登録します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetObjectData	SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

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

	名前	説明
	System.Runtime.Serialization.ISerializable.GetObjectData	派生クラスでオーバーライドされる場合、SerializationInfo インスタンスに、WebRequest をシリアル化するために必要なデータを設定します。