Content


        Request Object
 Request.BinaryRead Method
  
        Syntax:
  
        Parameters:
  
        Return Values:
  
        Remarks:
  Examples:
 Request.TotalBytes Property
  
        Syntax:
  
        Parameters:
  
        Remarks:
  Examples:

Request Object

Another function of Request object is the retrieving of HTTP data of a POST request from the client.

Request.BinaryRead Method

Request.BinaryRead Method retrieves the data part of a POST request by the server from the client.

Syntax:

BinaryRead(
count
)

Or in an ASP file. Imply

<% Request.BinaryRead(count) %>

Parameters:

count

The paramete "count" is used to specify the number of bytes to be read from the client. The total number of bytes that actually be read is less than or equal to Request.TotalBytes. "count" contains the number of bytes successfully read from the client after method return.

Return Values:

Return Values by this method contains an array of unsigned bytes. The data type of the return values is VT_ARRAY | VT_UI1, which is a variant array of unsigned, one-byte characters.

Remarks:

Data retrieves by the method from the client is stored in a SafeArray that contains information about the number of dimensions and the bounds of its dimensions.

The BinaryRead method is used to read the raw data sent by the client as part of a POST request. The raw data, which unlike the field variable format using the Request.Form collection, is a low-level format of data.

Examples:

HTTP form with POST method by BinaryRead

ASP script command:

<%
If Request.QueryString("binread")="y" then
    bin_total = Request.TotalBytes
    bin_req= Request.BinaryRead(bin_total)
    for i = 1 to bin_total
        Response.Write MidB(bin_req,i,1)
    next
end if
%>
<form action="http://127.0.0.1/form.asp?binread=y" method="post">
A:<input name="A" value="9" size="4" /> and
B:<input name="B" value="1" size="4" /> plus <input name="B" value="2" size="4" />
<input type="SUBMIT" />
</form>

HTTP Request (by Submit button):

http://127.0.0.1/form.asp

HTML web page ouput (Layout):

A: and B: plus

HTTP Request (by Submit button):

http://127.0.0.1/form.asp?binread=y

HTML web page ouput (Layout):

A: and B: plus

A=9&B=1&B=2

Request.TotalBytes Property

Request.TotalBytes Property is a read only property to specify the total number of bytes sent by the client in the body of the HTTP request

Syntax:

Request.TotalBytes()

Or in an ASP file. Imply

<% Request.TotalBytes() %>

Parameters:

void

This property has no parameters. A variable should assign to the Request.TotalBytes for receiving the total number of bytes sent by the client.

Remarks:

A read only property.

Examples:

Assign Request.TotalBytes to bin_total

ASP script command:mmand:

<%
bin_total = Request.TotalBytes
%>

©sideway

ID: 120200023 Last Updated: 2/9/2012 Revision: 0 Ref:

References

Active Server Pages, , http://msdn.microsoft.com/en-us/library/aa286483.aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929%28v=vs.90%29.aspx
ASP Best Practices, , http://technet.microsoft.com/en-us/library/cc939157.aspx
ASP Built-in Objects, , http://msdn.microsoft.com/en-us/library/ie/ms524716(v=vs.90).aspx
Response Object, , http://msdn.microsoft.com/en-us/library/ms525405(v=vs.90).aspx
Request Object, , http://msdn.microsoft.com/en-us/library/ms524948(v=vs.90).aspx
Server Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525541(v=vs.90).aspx
Application Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525360(v=vs.90).aspx
Session Object (IIS), , http://msdn.microsoft.com/en-us/library/ms524319(8v=vs.90).aspx
ASPError Object, , http://msdn.microsoft.com/en-us/library/ms524942(v=vs.90).aspx
ObjectContext Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525667(v=vs.90).aspx
Debugging Global.asa Files, , http://msdn.microsoft.com/en-us/library/aa291249(v=vs.71).aspx
How to: Debug Global.asa files, , http://msdn.microsoft.com/en-us/library/ms241868(v=vs.80).aspx
Calling COM Components from ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524620(v=VS.90).aspx
IIS ASP Scripting Reference, , http://msdn.microsoft.com/en-us/library/ms524664(v=vs.90).aspx
ASP Keywords, , http://msdn.microsoft.com/en-us/library/ms524672(v=vs.90).aspx
Creating Simple ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524741(v=vs.90).aspx
Including Files in ASP Applications, , http://msdn.microsoft.com/en-us/library/ms524876(v=vs.90).aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929(v=vs.90).aspx
FileSystemObject Object, , http://msdn.microsoft.com/en-us/library/z9ty6h50(v=vs.84).aspx
http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx, , ADO Object Model
ADO Fundamentals, , http://msdn.microsoft.com/en-us/library/windows/desktop/ms680928(v=vs.85).aspx