WebRequest.GetRequestStream メソッド

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

WebRequest.GetRequestStream メソッド

派生クラスでオーバーライドされると、インターネット リソースにデータを書き込むための Stream を返します。

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

Visual Basic (宣言)

Public Overridable Function
 GetRequestStream As Stream

Visual Basic (使用法)

Dim instance As WebRequest
Dim returnValue As Stream

returnValue = instance.GetRequestStream

C#

public virtual Stream GetRequestStream ()

C++

public:
virtual Stream^ GetRequestStream ()

J#

public Stream GetRequestStream ()

JScript

public function GetRequestStream () : Stream

戻り値
インターネット リソースにデータを書き込む Stream。

例外

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

解説

GetRequestStream メソッドは、インターネット リソースにデータを送信するために要求を初期化し、インターネット リソースにデータを送信するための Stream インスタンスを返します。

GetRequestStream メソッドは、Stream への同期アクセスを提供します。非同期アクセスでは、BeginGetRequestStream メソッドと EndGetRequestStream メソッドを使用します。

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

使用例

GetRequestStream メソッドを使用して、ストリームを取得し、そのストリームにデータを書き込む例を次に示します。

Visual Basic

' Set the 'ContentType' property of the WebRequest.
myWebRequest.ContentType = "application/x-www-form-urlencoded"

' Set the 'ContentLength' property of the WebRequest.
myWebRequest.ContentLength = byteArray.Length
Dim newStream As Stream = myWebRequest.GetRequestStream()
newStream.Write(byteArray, 0, byteArray.Length)

' Close the Stream object.
newStream.Close()

' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

C#

// Set the 'ContentType' property of the WebRequest.
myWebRequest.ContentType="application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest.ContentLength=byteArray.Length;
Stream newStream=myWebRequest.GetRequestStream();
newStream.Write(byteArray,0,byteArray.Length);

// Close the Stream object.
newStream.Close();

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();

C++

// Set the 'ContentType' property of the WebRequest.
myWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest->ContentLength = byteArray->Length;
Stream^ newStream = myWebRequest->GetRequestStream();
newStream->Write( byteArray, 0, byteArray->Length );

// Close the Stream object.
newStream->Close();

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

J#

// Set the 'ContentType' property of the WebRequest.
myWebRequest.set_ContentType("application/x-www-form-urlencoded");
// Set the 'ContentLength' property of the WebRequest.
myWebRequest.set_ContentLength(byteArray.get_Length());
Stream newStream = myWebRequest.GetRequestStream();
newStream.Write(byteArray, 0, byteArray.get_Length());
// Close the Stream object.
newStream.Close();
// Assign the response object of 'WebRequest' to a 'WebResponse' 
// variable.
WebResponse myWebResponse = myWebRequest.GetResponse();

プラットフォーム

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 クラス
WebRequest メンバ
System.Net 名前空間
BeginGetRequestStream
その他の技術情報
ネットワークでのストリームの使用