ContentEncoding Property

HttpListenerResponse.ContentEncoding Property

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

Gets or sets the Encoding for this response's OutputStream.

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

public Encoding ContentEncoding { get; set; }
/** @property */
public Encoding get_ContentEncoding ()

/** @property */
public void set_ContentEncoding (Encoding value)

public function get ContentEncoding () : Encoding

public function set ContentEncoding (value : Encoding)

Property Value

An Encoding object suitable for use with the data in the OutputStream property, or a null reference (Nothing in Visual Basic) if no encoding is specified.

An Encoding object can be used to convert byte sequences into character sets (code pages) and characters into byte sequences.

The following code example demonstrates using this property.

static string message403;
static void SendBadCertificateResponse(HttpListenerResponse response)
    StringBuilder message = new StringBuilder ();
    message.Append ("<HTML><BODY>");
    message.Append ("<p> Error message 403: Access is denied due to a missing or invalid client certificate.</p>");
    message.Append ("</BODY></HTML>");
    message403 = message.ToString();

    // Set up an authentication error response template.
    response.StatusCode = (int) HttpStatusCode.Forbidden;
    response.StatusDescription = "403 Forbidden";
    response.ProtocolVersion = new Version("1.1");
    response.SendChunked = false;
    // Turn the error message into a byte array using the 
    // encoding from the response when present.
    System.Text.Encoding encoding = response.ContentEncoding;
    if (encoding == null)
        encoding = System.Text.Encoding.UTF8;
        response.ContentEncoding = encoding;
    byte[] buffer = encoding.GetBytes (message403);
    response.ContentLength64 = buffer.Length;
    // Write the error message.
    System.IO.Stream stream = response.OutputStream;
    // Send the response.

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

© 2015 Microsoft