Export (0) Print
Expand All

HttpListenerResponse.ContentLength64 Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the number of bytes in the body data included in the response.

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

'Declaration
Public Property ContentLength64 As Long
'Usage
Dim instance As HttpListenerResponse
Dim value As Long

value = instance.ContentLength64

instance.ContentLength64 = value
/** @property */
public long get_ContentLength64 ()

/** @property */
public void set_ContentLength64 (long value)

public function get ContentLength64 () : long

public function set ContentLength64 (value : long)

Property Value

The value of the response's Content-Length header.

Exception typeCondition

ArgumentOutOfRangeException

The value specified for a set operation is less than zero.

InvalidOperationException

The response is already being sent.

ObjectDisposedException

This object is closed.

The Content-Length header expresses the length, in bytes, of the response's body data. When using the System.Net.EntitySendFormat.ContentLength send format, you must set the ContentLength64 property. If you do not, the HttpListener does not send the response data.

For a complete list of response headers, see the HttpResponseHeader enumeration.

The following code example demonstrates setting the value of this property.

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[] prefixes)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
        return;
    }
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length == 0)
      throw new ArgumentException("prefixes");
    
    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request. 
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Construct a response.
    string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    listener.Stop();
}

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

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

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft