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 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

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

file: /Techref/language/asp/obj/ref_vbom_resombw.htm, 3KB, , updated: 2003/5/15 14:13, local time: 2025/8/25 11:13,

^{216.73.216.125,10-3-159-76:LOG IN}

©2025 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?

Please DO link to this page! Digg it! / MAKE!

<A HREF="http://www.piclist.com/techref/language/asp/obj/ref_vbom_resombw.htm"> Response.BinaryWrite</A>

Did you find what you needed?

PICList 2025 contributors:
o List host: MIT, Site host massmind.org, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.