WebRequest クラス

定義

名前空間:

System.Net

アセンブリ:

netstandard.dll, System.Net.Requests.dll

ソース:

WebRequest.cs

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

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

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

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

継承

Object

MarshalByRefObject

WebRequest

派生

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

実装

ISerializable

例

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

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	子孫クラスでオーバーライドされると、送信される要求データのコンテンツ タイプを取得または設定します。
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 インスタンスを初期化します。
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)
RegisterPrefix(String, IWebRequestCreate)	指定した URI の WebRequest 子孫を登録します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

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

名前	説明
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	古い. 子孫クラスでオーバーライドされると、WebRequestのシリアル化に必要なデータを SerializationInfo インスタンスに設定します。

こちらもご覧ください

• HttpWebRequest
• データ を要求する
• プログラミング プラグ可能なプロトコル