WebRequest.GetRequestStream メソッド

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

Public Overridable Function GetRequestStream() As Stream
[C#]
public virtual Stream GetRequestStream();
[C++]
public: virtual Stream* GetRequestStream();
[JScript]
public function GetRequestStream() : Stream;

戻り値

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

例外

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

解説

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

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

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

使用例

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

 


' 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=S"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();

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

WebRequest クラス | WebRequest メンバ | System.Net 名前空間 | ネットワークでのストリームの使用 | BeginGetRequestStream