Export (0) Print
Expand All

HttpListenerResponse.Close Method (Byte(), Boolean)

Returns the specified byte array to the client and releases the resources held by this HttpListenerResponse instance.

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

'Declaration
Public Sub Close ( _
	responseEntity As Byte(), _
	willBlock As Boolean _
)

Parameters

responseEntity
Type: System.Byte()
A Byte array that contains the response to send to the client.
willBlock
Type: System.Boolean
true to block execution while flushing the stream to the client; otherwise, false.

ExceptionCondition
ArgumentNullException

responseEntity is Nothing.

ObjectDisposedException

This object is closed.

If you are sending body data with the response, you can use this method to send it as a Byte array instead of writing the body data to the OutputStream property and calling the Close method.

This method closes the response stream and the HttpListenerRequest associated with the response.

The following code example demonstrates calling this method.


' This example requires the System and System.Net namespaces.
Public Shared Sub SimpleListenerExample2(ByVal prefixes() As String)
    ' 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

    ' Create a listener.
    Dim listener As New HttpListener()
    ' Add the prefixes.
    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next s
    listener.Start()
    Console.WriteLine("Listening...")
    ' Note: The GetContext method 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 responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
    Dim buffer() As Byte = System.Text.Encoding.UTF8.GetBytes(responseString)
    ' Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length
    ' Demonstrate using the close overload that takes an 
    ' entity body.
    ' Specify true to block while data is transmitted.
    response.Close(buffer, True)
    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