Request.BinaryRead

The BinaryRead method retrieves data sent to the server from the client as part of a POST request. This method retrieves the data from the client and stores it in a SafeArray. A SafeArray is an array that contains information about the number of dimensions and the bounds of its dimensions.

Syntax

variant =Request.BinaryRead(count)

Parameters

variant: Contains an array of unsigned bytes returned by this method. This parameter will be of type VT_ARRAY | VT_UI1, which is a variant array of unsigned, one-byte characters.
count: Before execution, specifies how many bytes to read from the client. After this method returns, count contains the number of bytes successfully read from the client. The total number of bytes that will actually be read is less than or equal to Request.TotalBytes.

Remarks

The BinaryRead method is used to read the raw data sent by the client as part of a POST request. This method is used for low-level access to this data, as opposed to, for example, using the Request.Form collection to view form data sent in a POST request. After you have used BinaryRead, referring to any variable in the Request.Form collection causes an error. Conversely, after you have referred to a variable in the Request.Form collection, using BinaryWrite will cause an error. Remember, if you access a variable in the Request collection without specifying which subcollection it belongs to, the Request.Form collection may be searched, bringing this rule into force.

Example

The following example uses the BinaryRead method to place the content of a request into a SafeArray.

<%

  Dim vntPostedData, lngCount



  lngCount = Request.TotalBytes

  vntPostedData = Request.BinaryRead(lngCount)

%>

Applies To

Request 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_reqombr.htm, 4KB, , updated: 2005/9/20 17:16, local time: 2024/10/13 01:31,

^{35.171.164.77:LOG IN}

©2024 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://piclist.com/techref/language/asp/OBJ/ref_vbom_reqombr.htm"> Request.BinaryRead</A>

Did you find what you needed?

PICList 2024 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.