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

138 lines
5.1 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>Request Object</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">
<H2><A NAME="_request_object"></A><SUP></SUP>Request Object</H2>
<P>The <B>Request </B>object retrieves the values that the client browser passed to the server during an HTTP request.</P>
<H6>Syntax</H6>
<P><B>Request</B>[<B>.</B><I>collection|property|method</I>]<B>(</B><I>variable</I><B>)</B></P>
<P><B>&nbsp;</B></P>
<H6>Collections</H6>
<TABLE border=0 cellpadding=5 cols=2 frame=box rules=all>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob8q5h.htm"><B>ClientCertificate</B></A> </TD>
<TD width=69%>The values of fields stored in the client certificate that is sent in the HTTP request.</TD>
</TR>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob0z3o.htm"><B>Cookies</B></A></TD>
<TD width=69%>The values of cookies sent in the HTTP request.</TD>
</TR>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob4fl9.htm"><B>Form</B></A></TD>
<TD width=69%>The values of form elements in the HTTP request body.</TD>
</TR>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob53hj.htm"><B>QueryString</B></A></TD>
<TD width=69%>The values of variables in the HTTP query string.</TD>
</TR>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob5vsj.htm"><B>ServerVariables</B></A></TD>
<TD width=69%>The values of predetermined environment variables.</TD>
</TR>
</TABLE><BR>
<H6>Properties</H6>
<TABLE border=0 cellpadding=5 cols=2 frame=box rules=cols>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob1whf.htm"><B>TotalBytes</B></A></TD>
<TD width=69%>Read-only; specifies the total number of bytes the client is sending in the body of the request.</TD>
</TR>
</TABLE><BR>
<H6>Methods</H6>
<TABLE border=0 cellpadding=5 cols=2 frame=box rules=cols>
<TR VALIGN="top">
<TD width=31%><A HREF="/iishelp/iis/htm/asp/vbob8rl0.htm"><B>BinaryRead</B></A></TD>
<TD width=69%>Retrieves data sent to the server from the client as part of a POST request.</TD>
</TR>
</TABLE><BR>
<P>Variable parameters are strings that specify the item to be retrieved from a collection or to be used as input for a method or property. For more information about the <I>variable</I> parameter, see the individual collection descriptions.</P>
<H6>Remarks</H6>
<P>If the specified variable is not in one of the preceding five collections, the <B>Request</B> object returns EMPTY.</P>
<P>All variables can be accessed directly by calling <B>Request(</B><I>variable</I><B>)</B> without the collection name. In this case, the Web server searches the collections in the following order.
<OL>
<LI><B>QueryString</B></li>
<LI><B>Form</B></li>
<LI><B>Cookies</B></li>
<LI><B>ClientCertificate</B></li>
<LI><B>ServerVariables</B></li>
</OL>
<P>If a variable with the same name exists in more than one collection, the <B>Request </B>object returns the first instance that the object encounters.</P>
<P>It is strongly recommended that when referring to members of a collection the full name be used. For example, rather than <B>Request</B>.(AUTH_USER) use <B>Request.ServerVariables</B>(AUTH_USER). This will allow the server to locate the item more quickly.</P>
<H6>See Also</H6>
<P><A HREF="/iishelp/iis/htm/asp/vbob5sj8.htm"><B>Response</B> Object</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>