Response.BinaryWrite

The BinaryWrite method writes the specified information to the current HTTP output without any character conversion. This method is useful for writing nonstring information, such as binary data required by a custom application.

Syntax

Response.BinaryWrite data

Parameters

data

The data to write to the HTTP output. This parameter is of type VT_ARRAY | VT_UI1, which is a variant array of unsigned one-byte characters.

Example

If you have an object that generates an array of bytes, you can use the following call to BinaryWrite to send the bytes to a custom application:

<%

  Set objBinaryGen =index.html Server.CreateObject("MyComponents.BinaryGenerator")

  vntPicture = objBinaryGen.MakePicture

  Response.BinaryWrite vntPicture

%> 

 Note  An ASP application uses internal server buffers when writing data to the client, irrespective of the value of Response.Buffer. As the application is writing data synchronously, the data buffer can be reused when the BinaryWrite function returns, while the server is writing the data asynchronously to the client. The server, in turn, makes a copy of the data into its internal buffers. As a result of this buffering, the ASP application should not try to send unreasonable amounts of data in a single BinaryWrite, but rather break it into fragments so as to avoid running out of buffer space. Should the buffer space be exceeded, ASP error 251, "response exceeds the buffer limit," will be returned. While the default maximum buffer size is 4MB, the server administrator may increase it.

Applies To

Response Object

See Also

• Response.Write

Requirements

Platforms: Windows 2000 with IIS 5.0 installed, Windows XP with IIS 5.1 installed, Windows Server 2003 family with IIS 6.0 installed

Platform SDK Release: February 2003

What did you think of this topic?

Order a Platform SDK CD

  .