エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

WebRequest クラス

2013/12/12

Uniform Resource Identifier (URI) に対する要求を実行します。これは abstract クラスです。

Namespace:  System.Net
アセンブリ:  System.Net (System.Net.dll 内)

'宣言
Public MustInherit Class WebRequest

WebRequest 型で公開されるメンバーは以下のとおりです。

  名前説明
プロテクト メソッドWebRequestWebRequest クラスの新しいインスタンスを初期化します。
このページのトップへ

  名前説明
パブリック プロパティContentLength子孫クラスでオーバーライドされると、送信している要求データのコンテンツ長を取得または設定します。
パブリック プロパティContentType子孫クラスでオーバーライドされると、送信している要求データのコンテンツ タイプを取得または設定します。
パブリック プロパティCreatorInstance子孫クラスでオーバーライドされると、IWebRequestCreate クラスから派生するファクトリ オブジェクトを取得します。このクラスは、指定した URI に対して要求を行うためにインスタンス化される WebRequest の作成に使用されます。
パブリック プロパティCredentials子孫クラスでオーバーライドされると、インターネット リソースの要求の認証に使用するネットワーク資格情報を取得または設定します。
パブリック プロパティHeaders子孫クラスでオーバーライドされると、要求に関連付けられたヘッダーの名前/値ペアのコレクションを取得または設定します。
パブリック プロパティMethod子孫クラスでオーバーライドされると、要求で使用するプロトコル メソッドを取得または設定します。
パブリック プロパティRequestUri子孫クラスでオーバーライドされると、要求に関連付けられたインターネット リソースの URI を取得します。
パブリック プロパティUseDefaultCredentials子孫クラスでオーバーライドされると、既定の資格情報が要求と共に送信されるかどうかを制御する Boolean 値を取得または設定します。
このページのトップへ

  名前説明
パブリック メソッドAbort要求を中断します。
パブリック メソッドBeginGetRequestStream子孫クラスでオーバーライドされると、ストリームを要求するための非同期メソッドを提供します。
パブリック メソッドBeginGetResponse子孫クラスでオーバーライドされると、インターネット リソースの非同期要求を開始します。
パブリック メソッド静的メンバーCreate(String)指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。
パブリック メソッド静的メンバーCreate(Uri)指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。
パブリック メソッド静的メンバーCreateHttp(String)指定した URI 文字列用に新しい HttpWebRequest インスタンスを初期化します。
パブリック メソッド静的メンバーCreateHttp(Uri)指定した URI 用に新しい HttpWebRequest インスタンスを初期化します。
パブリック メソッドEndGetRequestStream子孫クラスでオーバーライドされると、インターネット リソースにデータを書き込むための Stream を返します。
パブリック メソッドEndGetResponse子孫クラスでオーバーライドされると、WebResponse を返します。
パブリック メソッドEquals(Object)指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。)
プロテクト メソッドFinalizeObject がガベージ コレクションで再利用される前に、Object がリソースを解放して他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
パブリック メソッドGetHashCode特定の型のハッシュ関数として機能します。 (Object から継承されます。)
パブリック メソッドGetType現在のインスタンスの Type を取得します。 (Object から継承されます。)
プロテクト メソッドMemberwiseClone現在の Object の簡易コピーを作成します。 (Object から継承されます。)
パブリック メソッド静的メンバーRegisterPrefix指定した URI 用の WebRequest 子孫クラスを登録します。
パブリック メソッドToString現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)
このページのトップへ

  名前説明
パブリック拡張メソッドGetCurrentNetworkInterfaceWeb 要求に対応するネットワーク インターフェイスに関するすべての使用可能な情報を取得します。 (WebRequestExtensions によって定義されています。)
パブリック拡張メソッドSetNetworkPreference携帯電話技術または携帯電話以外の技術に使う Web 要求の優先順位を設定します。 (WebRequestExtensions によって定義されています。)
パブリック拡張メソッドSetNetworkRequirement携帯電話技術または携帯電話以外の技術に使う Web 要求の要件を設定します。 (WebRequestExtensions によって定義されています。)
このページのトップへ

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

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

WebRequest クラスは、インターネット リソースへのアクセス中にエラーが発生したときに WebException をスローします。Status プロパティは、エラーの原因を示す WebExceptionStatus 値の 1 つです。

StatusUnknownError の場合は、Response プロパティを使用すると、プロトコル固有の応答エラーに関するさらに詳しい情報を取得できる場合があります。Response プロパティが null でない場合、エラー コードを含む応答がリモート サーバーから返されたことを示します。この場合は、Response プロパティを照会すると、応答に関する詳細な情報を取得できます。

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

メモメモ:

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

機能

この API をアプリ内で使用する場合は、アプリ マニフェストで次の機能を指定する必要があります。この機能を指定しないと、アプリが正しく機能しないか、予期せずに終了することがあります。

ID_CAP_NETWORKING

Windows Phone 8, Windows Phone OS 7.1

詳細については、「Windows Phone のアプリ機能とハードウェア要件」を参照してください。

継承時の注意

WebRequest から継承する場合は、次のメンバーをオーバーライドする必要があります。MethodRequestUriHeadersContentTypeCredentialsAbortBeginGetRequestStreamEndGetRequestStreamBeginGetResponse、および EndGetResponse。さらに、IWebRequestCreate インターフェイスの実装を指定する必要があります。これは、Create を呼び出すときに使用する Create メソッドを定義します。RegisterPrefix メソッドを使用して、IWebRequestCreate インターフェイスを実装するクラスを登録する必要があります。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

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

表示:
© 2015 Microsoft