HttpListenerRequest.InputStream プロパティ

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

HttpListenerRequest.InputStream プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

クライアントから送信された本体データを格納しているストリームを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 InputStream As Stream

Visual Basic (使用法)

Dim instance As HttpListenerRequest
Dim value As Stream

value = instance.InputStream

C#

public Stream InputStream { get; }

C++

public:
property Stream^ InputStream {
    Stream^ get ();
}

J#

/** @property */
public Stream get_InputStream ()

JScript

public function get InputStream
 () : Stream

プロパティ値
要求の本体でクライアントから送信されたバイトを格納している読み取り可能な Stream オブジェクト。要求と共にデータが送信されなかった場合、このプロパティは Null を返します。

解説

たとえば、HTTP の POST を使用してクライアントからデータが送信されている場合は、このメソッドから返されるストリームにそのデータが格納されます。

メモ
要求を終了しても、このプロパティから返されるストリームは閉じません。ストリームが不要になったら、Close メソッドを使用してストリームを閉じる必要があります。

呼び出し時の注意 このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

このプロパティを使用して、要求と共に送信されたデータを読み込むコード例を次に示します。

C#

public static void ShowRequestData
 (HttpListenerRequest request)
{
    if (!request.HasEntityBody)
    {
        Console.WriteLine("No client data was sent with the request.");
        return;
    }
    System.IO.Stream body = request.InputStream;
    System.Text.Encoding encoding = request.ContentEncoding;
    System.IO.StreamReader reader = new System.IO.StreamReader(body,
 encoding);
    if (request.ContentType != null)
    {
        Console.WriteLine("Client data content type {0}", request.ContentType);
    }
    Console.WriteLine("Client data content length {0}", request.ContentLength64);
   
    Console.WriteLine("Start of client data:");
    // Convert the data to a string and display it on the console.
    string s = reader.ReadToEnd();
    Console.WriteLine(s);
    Console.WriteLine("End of client data:");
    body.Close();
    reader.Close();
    // If you are finished with the request, it should be closed also.
}

プラットフォーム

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpListenerRequest クラス
HttpListenerRequest メンバ
System.Net 名前空間
HttpListener クラス
HttpListenerContext クラス
HttpListenerResponse