HttpListenerResponse.StatusCode Property

 

Gets or sets the HTTP status code to be returned to the client.

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

member StatusCode : int with get, set

Property Value

Type: System.Int32

An Int32 value that specifies the HTTP status code for the requested resource. The default is OK, indicating that the server successfully processed the client's request and included the requested resource in the response body.

Exception Condition
ObjectDisposedException

This object is closed.

ProtocolViolationException

The value specified for a set operation is not valid. Valid values are between 100 and 999 inclusive.

Clients use the status code returned by the server to decide how to proceed. A value of OK indicates that the server successfully processed the client's request and included the requested resource in the response body. Other common status codes include NotFound, indicating that the requested resource was not found on the server, and NotModified, indicating that it was unnecessary to return the requested resource in the response body because the client's cached copy of the resource is up-to-date.

For a complete list of possible status codes, see the HttpStatusCode enumeration.

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

public static string[] CopyPrefixes (HttpListener listener)
{
     HttpListenerPrefixCollection prefixes = listener.Prefixes;
     string[] prefixArray = new string[prefixes.Count];
     prefixes.CopyTo(prefixArray, 0);
     return prefixArray;
}

.NET Framework
Available since 2.0
Return to top
Show: