This documentation is archived and is not being maintained.

HttpListenerResponse.CopyFrom Method

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

Copies properties from the specified HttpListenerResponse to this response.

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

void CopyFrom (
	HttpListenerResponse^ templateResponse
public void CopyFrom (
	HttpListenerResponse templateResponse
public function CopyFrom (
	templateResponse : HttpListenerResponse



The HttpListenerResponse instance to copy.

If you regularly change many properties from their default values to a fixed set of new values, it is convenient to use an HttpListenerResponse instance as a template. Customize the template response once and, instead of configuring each response separately, call the CopyFrom method to configure a new response based on property values in the template response.

The following properties are copied from templateResponse to the current instance.

The following code example demonstrates creating a response by copying a template response.

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