2025-04-27 07:49:33 -04:00

97 lines
4.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">
<TITLE>BinaryRead</TITLE>
<SCRIPT LANGUAGE="JavaScript">
<!--
TempString = navigator.appVersion
if (navigator.appName == "Microsoft Internet Explorer"){
// Check to see if browser is Microsoft
if (TempString.indexOf ("4.") >= 0){
// Check to see if it is IE 4
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/coua.css">');
}
else {
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/cocss.css">');
}
}
else if (navigator.appName == "Netscape") {
// Check to see if browser is Netscape
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/coua.css">');
}
else
document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/cocss.css">');
//-->
</script>
<SCRIPT LANGUAGE="VBScript">
<!--
Sub Window_OnLoad()
Dim frmContents
On Error Resume Next
If Not Parent Is Nothing Then
Set frmContents = Parent.Contents
If Not frmContents Is Nothing Then
frmContents.Window.TOCSynch_Click
End If
End If
End Sub
//--></SCRIPT><META NAME="DESCRIPTION" CONTENT="Internet Information Services reference information">
<META HTTP-EQUIV="PICS-Label" CONTENT='(PICS-1.1 "<http://www.rsac.org/ratingsv01.html>" l comment "RSACi North America Server" by "inet@microsoft.com <mailto:inet@microsoft.com>" r (n 0 s 0 v 0 l 0))'>
<META NAME="MS.LOCALE" CONTENT="EN-US">
<META NAME="MS-IT-LOC" Content="Internet Information Services">
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
<H4><A NAME="_binaryread"></A><SUP></SUP>BinaryRead</H4>
<P>The <B>BinaryRead</B> 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 <B>SafeArray</B>. A <B>SafeArray</B> is an array that contains information about the number of dimensions and the bounds of its dimensions.</P>
<H6>Syntax</H6>
<P><I>variant</I> = <B>Request.BinaryRead</B>(<I>count</I>)</P>
<P>&nbsp;</P>
<H6>Parameters</H6>
<DL>
<DT><I>variant</I></DT>
<DD>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.<BR>
</DD>
<DT><I>count</I></DT>
<DD>Before execution, specifies how many bytes to read from the client. After this method returns, <I>count</I> will contain 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 <B>Request.TotalBytes</B>.</DD>
</DL>
<H6>Remarks</H6>
<P>The <B>BinaryRead</B> 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 <B>Request.Form</B> collection to view form data sent in a POST request. Once you have called <B>BinaryRead</B>, referring to any variable in the <B>Request.Form</B> collection will cause an error. Conversely, once you have referred to a variable in the <B>Request.Form</B> collection, calling <B>BinaryWrite</B> will cause an error. Remember, if you access a variable in the <B>Request </B>collection without specifying which subcollection it belongs to, the <B>Request.Form</B> collection may be searched, bringing this rule into force.</P>
<H6>Example</H6>
<P>The following example uses the <B>BinaryRead</B> method to place the content of a request into a safe array.</P>
<PRE><CODE>&lt;%
Dim vntPostedData, lngCount
lngCount = Request.TotalBytes
vntPostedData = Request.BinaryRead(lngCount)
%&gt;
</CODE></PRE>
<H6>Applies To</H6>
<P><A HREF="/iishelp/iis/htm/asp/vbob5ulw.htm"><B>Request</B> Object</A></P>
<H6>See Also</H6>
<P><A HREF="/iishelp/iis/htm/asp/vbob1whf.htm"><B>TotalBytes</B></A>, <A HREF="/iishelp/iis/htm/asp/vbob8q5h.htm"><B>ClientCertificate</B></A>, <A HREF="/iishelp/iis/htm/asp/vbob0z3o.htm"><B>Cookies</B></A>, <A HREF="/iishelp/iis/htm/asp/vbob4fl9.htm"><B>Form</B></A>, <A HREF="/iishelp/iis/htm/asp/vbob53hj.htm"><B>QueryString</B></A>, <A HREF="/iishelp/iis/htm/asp/vbob5vsj.htm"><B>ServerVariables</B></A></P>
<hr class="iis" size="1">
<p align="center"><em><a href="../../../common/colegal.htm">&copy; 1997-2001 Microsoft Corporation. All rights reserved.</a></em></p>
</BODY>
</HTML>