[IIS 5.0] [IIS 5.1] [IIS 6.0]
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
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
