Response Object

The most important function of Response object is the output of HTML contents to the client.

Response.Write Method

 Response.Write method is the method to write the specified string to the HTML output.

Syntax:

Write(
    variant
)

 Or in an ASP file. Imply

<% Response.Write (variant) %>

Parameters:

variant

The parameter "variant" is the information to write or to output. The data type of variant can be any VBScript supported variant data type, for example characters, stings, and integers.

However, the value of variant cannot contain the character combination "%>". Since the "%>" is the delimiter for the end of the enclosed script commands. Therefore the escape sequence "%\>" should be used and the escape sequence can then be translated by web server during processing the script.

Return Values:

void

The method has no return value. 

Remarks:

The output of the method is affected by the language code page and is equal to the default language code page by default. The output of the method can be encoded using diffferent code page by setting the AspCodePage metabase property. Or the output can also be encoded using different code pages by applying setting to the ASP script  commands, @CodePage, Response.CodePage, Session.CodePage.

  The Response.Write method to display the value of an parameter can be replaced by an output directive by replacing the expression of the output directive with the parameter of the Response.Write method

Examples:

• Simple Response.Write method

  ASP script command:

  <% Response.Write "<p>This is Output</p>" %>

  HTTP response output:

  <p>This is Output</p>

  HTML web page ouput:

  This is Output

• Response.Write method replaced by Output Directive

  ASP script command:

  <%= "<p>This is Output</p>" %>

  HTTP response output:

  <p>This is Output</p>

  HTML web page ouput:

  This is Output

• Simple Response.Write method

  ASP script command:

  <% Response.Write "<H1>This is Output</H1>" %>

  HTTP response output:

  <H1>This is Output</H1>

  HTML web page ouput:

  This is Output

• Simple Response.Write method

  ASP script command:

  <table border="5" width="65%"><tr><td>table</td></tr></table>

  HTTP response output:

  <table border="5" width="65%"><tr><td>table</td></tr></table>

  HTML web page ouput:

  table

Response.BinaryWrite Method

 Response.BinaryWrite method is the method to write the specified non-string data, binary data, to the HTML output directly without carrying out any character-set conversion.

Syntax:

BinaryWrite(
    data
)

 Or in an ASP file. Imply

<% Response.Write (data) %>

Parameters:

data

The parameter "data" is the data to write or to output. The data type of data is of type VT_ARRY|VT_UI1, a variant array of unsigned one-byte characters.

Return Values:

void

The method has no return value. 

Remarks:

When using the Response.BinaryWrite method to write data to the clinet, the amount or size of the data in one single Response.BinaryWrite should not be too large. In general, the web server send data to the client asynchronously while the ASP application is outputting the data synchronously. Therefore, the web server makes a copy of the ASP application output to the internal server buffer before send the output data to the client. The usage of internal server buffer is irrespective to the setting of Response.Buffer. And because there is a limit on the size of internal server buffer, when the output of ASP application exceeds the buffer space, an ASP error will occur. The ASP error 251; "response exceeds the buffer limit" will be return. Since the internal buffer space will be released when the Response.BinaryWrite method return, a single BinaryWrite method with large amounts of data can be break into fragments of small amounts of data in several BinaryWrite methods to avoid running out of buffer error. The default maximum internal server buffer size is 4MB, another way to avoid the running out of buffer is to increase the size of internal server buffer.

Examples:

• Simple Response.Binarywrite method

  ASP script command:

  <%
  Response.ContentType = "image/jpeg"
  Set objStream = Server.CreateObject("ADODB.Stream")
  objStream.Open
  objStream.Type = 1
  objStream.LoadFromFile server.mappath("\images\sideway.jpg")
  Response.BinaryWrite objStream.Read
  objStream.Close
  Set objStream = Nothing
  %>

  HTTP response output:

  ... binarydata stream ...

  HTML web page ouput: