[IIS 5.0] [IIS 5.1] [IIS 6.0]

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

See Also

• Request.TotalBytes
• Request.ClientCertificate Collection
• Request.Cookies Collection
• Request.Form Collection
• Request.QueryString Collection
• Request.ServerVariables Collection

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

  .