Export (0) Print
Expand All

HttpListenerResponse.ProtocolVersion Property

Gets or sets the HTTP version used for the response.

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

public:
property Version^ ProtocolVersion {
	Version^ get ();
	void set (Version^ value);
}
/** @property */
public Version get_ProtocolVersion ()

/** @property */
public void set_ProtocolVersion (Version value)

public function get ProtocolVersion () : Version

public function set ProtocolVersion (value : Version)

Not applicable.

Property Value

A Version object indicating the version of HTTP used when responding to the client. Note that this property is now obsolete.

Exception typeCondition

ArgumentNullException

The value specified for a set operation is a null reference (Nothing in Visual Basic).

ArgumentException

The value specified for a set operation does not have its Major property set to 1 or does not have its Minor property set to either 0 or 1.

ObjectDisposedException

This object is closed.

The capabilities of different HTTP versions are specified in the documents available at http://www.ietf.org.

The following code example demonstrates setting the value of 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;
    stream.Write(buffer,0,buffer.Length);
    // Send the response.
    response.Close();
}

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft