HttpListenerRequest.InputStream Property
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a stream that contains the body data sent by the client.
public:
property System::IO::Stream ^ InputStream { System::IO::Stream ^ get(); };
public System.IO.Stream InputStream { get; }
member this.InputStream : System.IO.Stream
Public ReadOnly Property InputStream As Stream
A readable Stream object that contains the bytes sent by the client in the body of the request. This property returns Null if no data is sent with the request.
The following code example demonstrates using this property to read the data sent with a request.
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.
}
Public Shared Sub ShowRequestData(ByVal request As HttpListenerRequest)
If Not request.HasEntityBody Then
Console.WriteLine("No client data was sent with the request.")
Return
End If
Dim body As System.IO.Stream = request.InputStream
Dim encoding As System.Text.Encoding = request.ContentEncoding
Dim reader As System.IO.StreamReader = New System.IO.StreamReader(body, encoding)
If request.ContentType IsNot Nothing Then
Console.WriteLine("Client data content type {0}", request.ContentType)
End If
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.
Dim s As String = 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.
End Sub
If the client transmits data (for example, using the HTTP POST
method), the stream returned by this method contains that data.
Note
Closing the request does not close the stream returned by this property. When you no longer need the stream, you should close it by calling the Close method.
This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework.
Product | Versions |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: