HttpWebResponse.GetResponseStream メソッド

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

HttpWebResponse.GetResponseStream メソッド

サーバーから応答の本文を読み取るために使用するストリームを取得します。

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

Visual Basic (宣言)

Public Overrides Function
 GetResponseStream As Stream

Visual Basic (使用法)

Dim instance As HttpWebResponse
Dim returnValue As Stream

returnValue = instance.GetResponseStream

C#

public override Stream GetResponseStream ()

C++

public:
virtual Stream^ GetResponseStream () override

J#

public Stream GetResponseStream ()

JScript

public override function GetResponseStream
 () : Stream

戻り値
応答の本文を格納している Stream。

例外

例外の種類	条件
ProtocolViolationException	応答ストリームがありません。
ObjectDisposedException	現在のインスタンスは破棄されています。

解説

GetResponseStream メソッドは、要求したインターネット リソースからデータ ストリームを返します。

メモ
ストリームを閉じて、再使用のための接続を解放するために Stream.Close メソッドまたは HttpWebResponse.Close メソッドを呼び出す必要があります。Stream.Close と HttpWebResponse.Close の両方を呼び出す必要はありません。ただし、両方呼び出してもエラーは発生しません。ストリームを閉じないと、アプリケーションで接続が不足することがあります。

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

使用例

GetResponseStream を使用して、サーバーから応答を読み取るための Stream インスタンスを返す方法の例を次に示します。

Visual Basic

' Creates an HttpWebRequest for the specified URL. 
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(url),
 HttpWebRequest)
' Sends the request and waits for a response.            
Dim myHttpWebResponse As HttpWebResponse =
 CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
' Calls the method GetResponseStream to return the stream associated
 with the response.
Dim receiveStream As Stream = myHttpWebResponse.GetResponseStream()
Dim encode As Encoding = System.Text.Encoding.GetEncoding("utf-8")
' Pipes the response stream to a higher level stream reader with the
 required encoding format. 
Dim readStream As New StreamReader(receiveStream,
 encode)
Console.WriteLine(ControlChars.Lf + ControlChars.Cr + "Response
 stream received")
Dim read(256) As [Char]
' Reads 256 characters at a time.    
Dim count As Integer = readStream.Read(read,
 0, 256)
Console.WriteLine("HTML..." + ControlChars.Lf + ControlChars.Cr)
While count > 0
    ' Dumps the 256 characters to a string and displays the string to
 the console.
    Dim str As New [String](read,
 0, count)
    Console.Write(str)
    count = readStream.Read(read, 0, 256)
End While
Console.WriteLine("")
' Releases the resources of the Stream.
readStream.Close()
 ' Releases the resources of the response.
myHttpWebResponse.Close()

C#

// Creates an HttpWebRequest with the specified URL. 
    HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.Create(url); 
    // Sends the HttpWebRequest and waits for the response.        
    
    HttpWebResponse myHttpWebResponse = (HttpWebResponse)myHttpWebRequest.GetResponse();
 
    // Gets the stream associated with the response.
    Stream receiveStream = myHttpWebResponse.GetResponseStream();
    Encoding encode = System.Text.Encoding.GetEncoding("utf-8");
    // Pipes the stream to a higher level stream reader with the required
 encoding format. 
    StreamReader readStream = new StreamReader( receiveStream,
 encode );
Console.WriteLine("\r\nResponse stream received.");
    Char[] read = new Char[256];
    // Reads 256 characters at a time.    
    int count = readStream.Read( read, 0, 256 );
    Console.WriteLine("HTML...\r\n");
    while (count > 0) 
        {
            // Dumps the 256 characters on a string and displays the
 string to the console.
            String str = new String(read, 0, count);
            Console.Write(str);
            count = readStream.Read(read, 0, 256);
        }
    Console.WriteLine("");
    // Releases the resources of the response.
    myHttpWebResponse.Close();
    // Releases the resources of the Stream.
    readStream.Close();

C++

// Creates an HttpWebRequest with the specified URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( url ) );
// Sends the HttpWebRequest and waits for the response.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse()
 );
// Gets the stream associated with the response.
Stream^ receiveStream = myHttpWebResponse->GetResponseStream();
Encoding^ encode = System::Text::Encoding::GetEncoding( "utf-8" );
// Pipes the stream to a higher level stream reader with the required
 encoding format.
StreamReader^ readStream = gcnew StreamReader( receiveStream,encode );
Console::WriteLine( "\r\nResponse stream received." );
array<Char>^ read = gcnew array<Char>(256);
// Reads 256 characters at a time.
int count = readStream->Read( read, 0, 256 );
Console::WriteLine( "HTML...\r\n" );
while ( count > 0 )
{
   // Dumps the 256 characters on a String* and displays the String*
 to the console.
   String^ str = gcnew String( read,0,count );
   Console::Write( str );
   count = readStream->Read( read, 0, 256 );
}
Console::WriteLine( "" );
// Releases the resources of the response.
myHttpWebResponse->Close();
// Releases the resources of the Stream.
readStream->Close();

J#

// Creates an HttpWebRequest with the specified URL. 
HttpWebRequest myHttpWebRequest = (HttpWebRequest)
    WebRequest.Create(url);

// Sends the HttpWebRequest and waits for the response.            
HttpWebResponse myHttpWebResponse = (HttpWebResponse)
    myHttpWebRequest.GetResponse();

// Gets the stream associated with the response.
Stream receiveStream = myHttpWebResponse.GetResponseStream();
Encoding encode = System.Text.Encoding.GetEncoding("utf-8");

// Pipes the stream to a higher level stream reader with the 
// required encoding format. 
StreamReader readStream = new StreamReader(receiveStream, encode);
Console.WriteLine("\r\nResponse stream received.");
char read[] = new char[256];

// Reads 256 characters at a time.    
int count = readStream.Read(read, 0, 256);

Console.WriteLine("HTML...\r\n");
while (count > 0) {
    // Dumps the 256 characters on a string and displays the
    // string to the console.
    String str = new String(read, 0, count);
    Console.Write(str);
    count = readStream.Read(read, 0, 256);
}
Console.WriteLine("");
// Releases the resources of the response.
myHttpWebResponse.Close();
// Releases the resources of the Stream.
readStream.Close();

プラットフォーム

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

参照

関連項目
HttpWebResponse クラス
HttpWebResponse メンバ
System.Net 名前空間