Export (0) Print
Expand All

HttpListenerResponse.OutputStream Property

Gets a Stream object to which a response can be written.

Namespace:  System.Net
Assembly:  System (in System.dll)

'Declaration
Public ReadOnly Property OutputStream As Stream

Property Value

Type: System.IO.Stream
A Stream object to which a response can be written.

ExceptionCondition
ObjectDisposedException

This object is closed.

The ContentLength64 property must be set explicitly before writing to the returned Stream object.

NoteNote

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.

The following code example demonstrates calling this method.


' This example requires the System and System.Net namespaces.
Public Shared Function ClientInformation(ByVal context As HttpListenerContext) As String
    Dim user As System.Security.Principal.IPrincipal = context.User
    Dim id As System.Security.Principal.IIdentity = user.Identity
    If id Is Nothing Then
        Return "Client authentication is not enabled for this Web server."
    End If

    Dim display As String
    If id.IsAuthenticated Then
        display = String.Format("{0} was authenticated using {1}", id.Name, id.AuthenticationType)
    Else
        display = String.Format("{0} was not authenticated", id.Name)
    End If
    Return display
End Function

Public Shared Sub SimpleListenerWithAuthentication(ByVal prefixes() As String)
    If Not HttpListener.IsSupported Then
        Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.")
        Return
    End If

    ' URI prefixes are required,
    ' for example "http://contoso.com:8080/index/".
    If prefixes Is Nothing OrElse prefixes.Length = 0 Then
        Throw New ArgumentException("prefixes")
    End If

    ' Set up a listener.
    Dim listener As New HttpListener()
    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next s
    listener.Start()
    ' Specify Negotiate as the authentication scheme.
    listener.AuthenticationSchemes = AuthenticationSchemes.Negotiate
    Console.WriteLine("Listening...")
    ' GetContext blocks while waiting for a request. 
    Dim context As HttpListenerContext = listener.GetContext()
    Dim request As HttpListenerRequest = context.Request
    ' Obtain a response object.
    Dim response As HttpListenerResponse = context.Response
    ' Construct a response.
    Dim clientInformation As String = ListenerBasic.ClientInformation(context)
    Dim buffer() As Byte = System.Text.Encoding.UTF8.GetBytes("<HTML><BODY> " & clientInformation & "</BODY></HTML>")
    ' Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length
    Dim output As System.IO.Stream = response.OutputStream
    output.Write(buffer, 0, buffer.Length)
    output.Close()
    listener.Stop()
End Sub


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft