社区服务
银行
门派

风格切换
wind
wind5

IECN社区 » ASP/.Net/MSSQL » 转：Asp Object 对象

本页主题: 转：Asp Object 对象打印 \| 加为IE收藏 \| 复制链接 \| 收藏主题 \| 上一主题 \| 下一主题

枫岩

我在想念心已累倦

级别: 总版主

精华: 12
发帖: 25391
威望: 21623 点
财富: 4598 K币
贡献值: 3 点
注册时间:2003-12-28
最后登录:2009-11-11

小中大引用推荐编辑只看复制

转：Asp Object 对象

系统提示：这是一个从旧版社区导入的帖子。
如果显示不正常，或需要查找旧帖中上传的附件，请参照原帖。
原帖地址：http://my.iecn.net/bbs/view/18754.html
如非必要，请不要修改此帖！如果修改，请保留以上信息。

来源于：www.51windows.Net
作者：海娃

代码：

<HTML><HEAD><META HTTP-EQUIV="Content-Type" Content="text-html; charset=GB2312"><META NAME="Author" CONTENT="51windows,海娃,haiwa"><META NAME="Description" CONTENT="Power by 51windows.Net"><title>Asp Object 对象 -www.51windows.Net</title><style>/*海娃@www.51windows.net*/a:link			{font:9pt/12pt 宋体, MS Song; color:red}a:visited		{font:9pt/12pt 宋体, MS Song; color:#4e4e4e}body,p,ul,li,td,dd{font:9pt/12pt 宋体, MS Song; color:#000000}pre{font-size:11px;font-family:Verdana;word-break:break-all;}b{font-size:11px;font-family:Verdana;font-weight:bold;}i,code{font-size:11px;font-family:Verdana;font-weight:normal;}dt i{font-size:11px;font-family:Verdana;font-weight:normal;text-decoration: underline;}h4{font-size:14px;font-weight:bold;}h2{font-size:18pt;font-weight:bold;font-family:Verdana;}.T{font-size:11px;font-family:Verdana;font-weight:bold;width:120px;color:red;}</style><BODY BGCOLOR=#FFFFFF TEXT=#000000 ondblclick=body.scrollTop=0; title="双击回顶端"><a class="T" href="#_AddHeader">AddHeader</a> 
<a class="T" href="#_AppendToLog">AppendToLog</a> 
<a class="T" href="#_BinaryRead">BinaryRead</a> 
<a class="T" href="#_BinaryWrite">BinaryWrite</a> 
<a class="T" href="#_Buffer">Buffer</a> 
<a class="T" href="#_CacheControl">CacheControl</a> 
<a class="T" href="#_Charset">Charset</a> 
<a class="T" href="#_Clear">Clear</a> 
<a class="T" href="#_ClientCertificate">ClientCertificate</a> 
<a class="T" href="#_ContentType">ContentType</a> 
<a class="T" href="#_End">End</a> 
<a class="T" href="#_ServerVariables">ServerVariables</a> 
<a class="T" href="#_Expires">Expires</a> 
<a class="T" href="#_ExpiresAbsolute">ExpiresAbsolute</a> 
<a class="T" href="#_Flush">Flush</a> 
<a class="T" href="#_Form">Form</a> 
<a class="T" href="#_IsClientConnected">IsClientConnected</a> 
<a class="T" href="#_PICS">PICS</a> 
<a class="T" href="#_QueryString">QueryString</a> 
<a class="T" href="#_Redirect">Redirect</a> 
<a class="T" href="#_Cookies_Request">Request.Cookies</a> 
<a class="T" href="#_Request_object">Request</a> 
<a class="T" href="#_Cookies_Response">Response.Cookies</a> 
<a class="T" href="#_Response_object">Response</a> 
<a class="T" href="#_Status">Status</a> 
<a class="T" href="#_TotalBytes">TotalBytes</a> 
<a class="T" href="#_Write">Write</a><font face="宋体, 宋体, 宋体"><h2><a name="_addheader"></a>AddHeader</h2><p><b>AddHeader </b>方法用指定的值添加 HTML 标题。该方法常常向响应添加新的 HTTP 标题。它并不替代现有的同名标题。一旦标题被添加，将不能删除。</p> 
<p>此方法仅供高级用户使用。若其他 Response 方法提供了您所需的功能，建议您使用该方法。</p> 
<h4>语法</h4><pre><b>Response.AddHeader</b> <i>name</i><b>,</b> <i>value </i></pre><h4>参数</h4><dl><dt><i>name</i></dt><dd>新的标题变量的名称。<br></dd><dt><i>value</i></dt><dd>存储在新的标题变量中的初始值。</dd></dl><h4>注释</h4><p>为避免命名不明确，<i>name</i> 中不能包含任何下划线字符 (_)。<b>ServerVariables</b> 集合将标题中的下划线字符解释为反斜杠。例如，下面的脚本使服务器查找一个名为 MY-HEADER 的标题名。</p> 
<code>&lt;% Request.ServerVariables(&quot;HTTP_MY_HEADER&quot;) %&gt;</code> 
<p>由于 HTTP 协议要求所有的标题都必须在内容之前发送，所以您必须在任何的输出（例如由 HTML 或 <a href="#_Write"><b>Write</b></a> 方法生成的输出）发送到客户端之前在脚本中调用 <b>AddHeader</b>。但当 <a href="#_Flush"><b>Buffer</b></a> 属性被设置为 TRUE 时例外。若输出被缓冲，那么您就可以在脚本中的任何地方调用 <b>AddHeader </b>方法，只要它在 <a href="#_Flush"><b>Flush</b></a> 之前执行即可。否则，对 <b>AddHeader </b>的调用将产生一个运行错误。</p> 
<p>下面的两个 .asp 文件对这一点进行了解释。</p> 
<pre>-------file1.asp---------
&lt;% Response.AddHeader &quot;WARNING&quot;, &quot;Error Message Text&quot; %&gt; 
&lt;HTML&gt;Some text on the Web page.
&lt;/HTML&gt; </pre><p>在前面的例子中，页没有缓冲。但是，因为在服务器将输出</p><pre>Some text on the Web page </pre><p>发送到客户端之前调用了 <b>AddHeader </b>方法，所以脚本能正常工作。如果调换一下顺序，则对 <b>AddHeader </b>方法的调用将产生一个运行时错误。</p> 
<pre>------file2.asp----------
&lt;% Response.Buffer = TRUE %&gt; 
&lt;HTML&gt;Here's some text on your Web page.
&lt;% Response.AddHeader &quot;WARNING&quot;, &quot;Error Message Text&quot; %&gt; Here's some more interesting and illuminating text.
&lt;% Response.Flush %&gt; 
&lt;%= Response.Write(&quot;some string&quot;) %&gt; 
&lt;/HTML&gt; </pre><p>在前面的示例中，页被缓冲了，其结果是，直到此页上所有的 ASP 脚本执行后或 <a href="#_Flush"><b>Flush</b></a> 方法被调用后，服务器才会将输出发送到客户端。带缓冲的输出中对 <b>AddHeader </b>的调用可在脚本的任何地方出现，只要在 <b>Flush</b> 调用之前即可。在前面的示例中，若对 <b>AddHeader</b> 的调用在对 <b>Flush</b> 的调用之后出现，脚本将产生一个运行时错误。</p> 
<p>您可以通过这一方法用不同的值发送同一标题的多份拷贝，比如用 WWW-Authenticate 标题。</p> 
<h4>示例</h4><p>下面这个示例使用 <b>AddHeader </b>方法要求客户端使用 BASIC 验证。</p> 
<pre>&lt;% Response.Addheader &quot;WWW-Authenticate&quot;, &quot;BASIC&quot; %&gt; </pre><p><b>注意</b> 前面的脚本仅通知客户端浏览器使用哪个验证。若您在 Web 应用程序中使用该脚本，则一定要启用 Web 服务器的 BASIC 验证。</p> 
<h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p><h4>请参阅</h4><p><a href="#_Flush"><b>Flush</b></a>、<a href="#_Write"><b>Write</b></a>、<a href="#_Buffer"><b>Buffer</b></a> </p><hr class="iis" size="1"><h2><a name="_appendtolog"></a>AppendToLog</h2><p><b>AppendToLog </b>方法将字符串添加到 Web 服务器日志条目的末尾。可以在脚本的同一部分中多次调用该方法。每次调用该方法时，都会在当前条目中添加指定的字符串。</p> 
<h4>语法</h4><pre><b>Response.AppendToLog</b> <i>string </i></pre><h4>参数</h4><dl><dt><i>string</i></dt><dd>要添加到日志文件中的文本。由于 IIS 日志中的字段由逗号分隔，所以该字符串中不能包含逗号 (,)。字符串最大长度为 80 个字符。</dd> 
</dl><h4>注释</h4><p>为使指定的字符串被记录到日志文件中，必须启用站点 Extended Logging 属性页的 URI Query 选项，该站点是要登录的活动站点。有关配置 Extended Logging 的详细信息，请参阅 <a >Customizing W3C Extended Logging</a>。</p> 
<h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_binaryread"></a>BinaryRead</h2><p><b>BinaryRead</b> 方法获取作为 POST 请求的一部分而从客户端传送到服务器的数据。此方法获取来自客户端的数据并将其储存在 <b>SafeArray</b> 中。<b>SafeArray</b> 是一个数组，其中包含维数和边界信息。</p> 
<h4>语法</h4><pre><i>variant</i> = <b>Request.BinaryRead</b>(<i>count</i>) </pre><h4>参数</h4><dl><dt><i>variant</i></dt><dd>包含由该方法返回的无符号数的数组。该参数的类型为 VT_ARRAY | VT_UI1。 <br> 
</dd><dt><i>count</i></dt><dd>在执行前，指定要从客户端读取的字节数。此方法返回后，<i>count</i> 将包含从客户机成功读取的字节数。实际读取的字节总数将小于或等于 <b>Request.TotalBytes</b>。</dd> 
</dl><h4>注释</h4><p><b>BinaryRead</b> 方法用于读取作为 POST 请求的一部分从客户端发出的未加工数据。此方法用于在底层访问数据，与此相反，<b>Request.Form</b> 集合用于查看在公告请求中发送的表格数据。一旦调用了 <b>BinaryRead</b>，则引用 <b>Request.Form</b> 集合中的任何变量都将导致错误发生。反之，一旦引用了 <b>Request.Form</b> 集合中的一个变量，则调用 <b>BinaryWrite</b> 也将导致错误发生。请记住，如果在访问 <b>Request </b>集合中的变量时未指定该变量属于哪一个子集，将搜索 
Request.Form 集合并强制使用上述规则。</p> 
<h4>示例</h4><p>下列示例使用 <b>BinaryRead</b> 方法将请求的内容放入一个安全的数组中。</p> 
<pre>&lt;%
Dim binread
Dim bytecount 
bytecount = Request.TotalBytes
binread = Request.BinaryRead(bytecount)
%&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Request 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_TotalBytes"><b>TotalBytes</b></a>、<a href="#_ClientCertificate"><b>ClientCertificate</b></a>、<a href="#_Cookies_Request"><b>Cookies</b></a>、<a href="#_Form"><b>Form</b></a>、<a href="#_QueryString"><b>QueryString</b></a>、<a href="#_ServerVariables"><b>ServerVariables</b></a> </p><hr class="iis" size="1"><h2><a name="_binarywrite"></a>BinaryWrite</h2><p><b>BinaryWrite </b>方法不经任何字符转换就将指定的信息写到 HTTP 输出。该方法用于写非字符串信息（如客户端应用程序所需的二进制数据）。 </p> 
<h4>语法</h4><pre><b>Response.BinaryWrite</b> <i>data </i></pre><h4>参数</h4><dl><dt><i>data</i></dt><dd>写到 HTTP 输出的数据。</dd> 
</dl><h4>示例</h4><p>如果有一个产生字节数组的对象，就如下调用 <b>BinaryWrite</b> 将这些生成的字节发送给客户端应用程序。</p> 
<pre>&lt;%
Set BinGen = Server.CreateObject(MY.BinaryGenerator)
Pict = BinGen.MakePicture
Response.BinaryWrite Pict
%&gt; 
</pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_Write"><b>Write</b></a> </p><hr class="iis" size="1"><h2><a name="_buffer"></a>Buffer</h2><p><b>Buffer</b> 属性指示是否缓冲页输出。当缓冲页输出时，只有当前页的所有服务器脚本处理完毕或者调用了 <b>Flush</b> 或 <b>End</b> 方法后，服务器才将响应发送给客户端。 </p> 
<p>服务器将输出发送给客户端后就不能再设置 <b>Buffer</b> 属性。因此，应该在 .asp 文件的第一行调用 <b>Response.Buffer</b> 。</p> 
<h4>语法</h4><pre><b>Response.Buffer </b>[<b>=</b> <i>flag</i>] </pre><h4>参数</h4><dl><dt><i>flag</i></dt><dd>指定是否缓冲页输出，可为如下值之一。 <table><tr valign=top><td><b>值</b></td><td><b>说明</b></td></tr><tr valign=top><td>FALSE</td><td>不缓冲。该值是默认值。服务器在处理脚本的同时将输出发送给客户端。</td></tr><tr valign=top><td>TRUE</td><td>除非当前页的所有 ASP 脚本处理完毕或调用了 <b>Flush</b> 或 <b>End</b> 方法，否则服务器不将响应发送给客户端。</td> 
</tr></table><br></dd></dl><h4>注释</h4><p>如果当前 ASP 脚本缓冲设为 TRUE ，但未调用 <a href="#_Flush"><b>Flush</b></a> 方法，则服务器将使客户端的请求保持活动。由于服务器不必为每个客户端创建新的连接，从而节省了时间。</p> 
<p>不过，缓冲将在服务器未处理完当前页的所有脚本之前阻止在客户端显示响应。对于长的脚本来说，有可能会感觉到延迟。</p><p>您可用元数据库中的 <a href="#_/iishelp/iis/htm/sdk/arpr719q"><b>ASPBufferingOn</b></a> 属性设置脚本缓冲默认值。关于使用元数据库的详细信息，请参阅程序员参考中的 <a href="/iishelp/iis/htm/sdk/aaad7h9h"><b>IIS 元数据库</b></a>。</p> 
<h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_Flush"><b>Flush</b></a>、<a href="#_End"><b>End</b></a> </p><hr class="iis" size="1"><h2><a name="_cachecontrol"></a>CacheControl</h2><p><b>CacheControl </b> 属性忽略 Private 默认值。当你设置其属性为 Public 时, 代理服务器可以缓冲由 ASP 产生的输出。</p> 
<h4>语法</h4><pre><b>Response.CacheControl </b>[<b>=</b> <i>Cache Control Header </i>] </pre><h4> 参数 </h4><dl><dt><i>Cache control Header</i></dt> 
<dd>缓冲存储器控制标题可以是 Public 或 Private。 </dd> 
</dl><h4>应用于 </h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_charset"></a>Charset</h2><p><b>Charset</b> 属性将字符集名称（如 ISO-LATIN-7）附加到 Response 对象中 content-type 标题的后面。</p> 
<h4>语法</h4><pre><b>Response.Charset</b>(<i>CharsetName</i>) </pre><h4>参数</h4><dl><dt><i>CharsetName</i></dt><dd>指定该网页的字符集的字符串。字符集的名称将被附加到 <b>Response </b>对象中的 content-type 标题的后面。</dd> 
</dl><h4>示例</h4><p>对于不包含 <b>Response.Charset</b> 属性的 ASP 页，content-type 标题将为：</p> 
<pre>content-type:text/html
</pre><p>如果同样的 .asp 文件包含</p> 
<pre>&lt;% Response.Charset(&quot;ISO-LATIN-7&quot;) %&gt;</pre><p>则 content-type 标题将为：</p> 
<pre>content-type:text/html; charset=ISO-LATIN-7 </pre><h4>注释</h4><p>无论字符串表示的字符集是否有效，该功能都会将其插入 content-type 标题中。</p> 
<p>如果某个页包含多个含有 <b>Response.Charset</b> 的标记，则每个 <b>Response.Charset </b>都将替代前一个 <i>CharsetName</i>。这样，字符集将被设置为该页中 <b>Response.Charset </b>的最后一个实例所指定值。</p> 
<p>在 Macintosh 系统上，默认的 U.S. 字符集设置不是 ISO-LATIN-1。当处理文档时，用于 Macintosh 系统的个人 Web 服务器自动从 Macintosh 字符集转换为 ISO-Latin-1。在 U.S. 版本中，如果未使用 <b>Response.Charset</b> 转换字符集，而且用于 Macintosh 系统的个人 Web 服务器不转换字符集，那么所有网页都被假定为在 U.S. Macintosh 字符集中。</p><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p><hr class="iis" size="1"><h2><a name="_clear"></a>Clear</h2><p><b>Clear </b>方法删除缓冲区中的所有 HTML 输出。但 <b>Clear </b>方法只删除响应正文而不删除响应标题。可以用该方法处理错误情况。请注意，如果未将 <b>Response.Buffer </b>设置为 TRUE，则该方法将导致运行时错误。</p> 
<h4>语法 </h4><pre><b>Response.Clear</b> </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_End"><b>End</b></a>、<a href="#_Flush"><b>Flush</b></a> </p><hr class="iis" size="1"><h2><a name="_clientcertificate"></a>ClientCertificate</h2><p><b>ClientCertificate</b> 集合从 Web 浏览器发布请求中获取验证字段（由 X.509 标准指定）。<p> 
<p>如果 Web 浏览器使用 SSL3.0/PCT1 协议（也就是说，它使用以 https:// 开头的 URL，而不是 http://）连接服务器及服务器请求验证，则浏览器将发送验证字段。</p> 
<p>如果没有发送验证，<b>ClientCertificate</b> 集合将返回 EMPTY。</p> 
<p>必须先将 Web 服务器配置为要求客户端验证，然后才能使用 <b>ClientCertificate</b> 集合。</p> 
<h4>语法</h4><pre><b>Request.ClientCertificate(</b> <i>Key</i>[<i>SubField</i>] <b>) </b></pre><h4>参数</h4><dl><dt><i>Key</i></dt><dd>指定要获取的验证字段名称。客户端验证包括下列字段。<table><tr valign=top><td><b>值</b></td><td><b>意义</b></td></tr><tr valign=top><td>Certificate</td><td>按 ASN.1 格式的二进制流字符串，其中包括完整的验证内容。</td> 
</tr><tr valign=top><td>Flags</td><td>一组标志，提供其他客户端验证信息。可以设置下面的标志：<p><b>ceCertPresent</b> - 当前的客户端验证。</p> 
<p><b>ceUnrecognizedIssuer</b> - 该链上来自未知的发布者的最后一个验证。</p> 
<p><b>注意</b> 要使用以上标志，必须在 ASP 页中包含客户端验证包含文件。若您正在使用 VBScript，则应包含 cervbs.inc。这些文件安装在 InetpubASPSampSamples 目录下。</p> 
</td></tr><tr valign=top><td>Issuer</td><td>包含子字段值的列表的字符串，此列表包含验证发布者的信息。若该值在无 <i>SubField</i> 项的情况下指定，则 <b>ClientCertificate</b> 集合返回一个以逗号分隔的子字段列表。例如，C=US, O=Verisign 等。</td> 
</tr><tr valign=top><td>SerialNumber</td><td>包含验证的序列号的字符串，序列号以连字符 (-) 分隔的 16 进制 ASCII 码表示。例如，04-67-F3-02。</td> 
</tr><tr valign=top><td>Subject</td><td>包含子字段值的列表的字符串，此列表包含有关验证的主题信息。若该值在无 <i>SubField</i> 项的情况下指定，则 <b>ClientCertificate</b> 集合返回一个以逗号分隔的子字段列表。例如，C=US, O=Verisign 等。</td> 
</tr><tr valign=top><td>ValidFrom</td><td>指定验证何时有效。此日期遵循 VBScript 格式并随国家（地区）设置而变化。例如，在美国可表示为 9/26/96 11:59:59 <small>PM.</small></td> 
</tr><tr valign=top><td>ValidUntil</td><td>指定验证何时到期。</td></tr></table><br><br></dd><dt><i>SubField</i></dt><dd>可选参数，用于按 Subject 或 Issuer 关键字检索单独的字段。此参数作为一个后缀添加到 <i>Key </i>参数中。例如，IssuerO 或 SubjectCN。下表列出了一些通用的 <i>SubField</i> 值。<table> 
<tr valign=top><td><b>值</b></td><td><b>意义</b></td></tr><tr valign=top><td>C</td><td>指定原国家（地区）名。</td></tr><tr valign=top><td>CN</td><td>指定公用用户名。（此子字段仅同 Subject 关键字一起使用。）</td> 
</tr><tr valign=top><td>GN</td><td>指定给定的名称。</td></tr><tr valign=top><td>I</td><td>指定一组首字母。</td></tr><tr valign=top><td>L</td><td>指定所在地。</td></tr><tr valign=top><td>O</td><td>指定公司或组织名称。</td></tr><tr valign=top><td>OU</td><td>指定机构的名称。</td></tr><tr valign=top><td>S</td><td>指定州或省。</td></tr><tr valign=top><td>T</td><td>指定此人或组织的头衔。</td></tr></table><br><p>与在上述列表中所列的值不同，<i>SubField </i>的值可被 ASN.1 标识所识别。ASN.1 标识的格式是一串通过句点 (.) 分隔的一系列数。例如： 3.56.7886.34。</p> 
</dd></dl><h4>注释</h4><p>可以通过关键字用循环来遍历 <b>ClientCertificate</b> 集合。下面的例子对此进行演示。</p> 
<pre>&lt;%
For Each key in Request.ClientCertificate Response.Write( key &amp; &quot;: &quot; &amp; Request.ClientCertificate(key) &amp; &quot;&lt;BR&gt;&quot;)
Next
%&gt; </pre><h4>示例</h4><p>下面的示例使用 <code>Subject</code> 关键字测试客户端验证是否存在。</p> 
<pre>&lt;%
If Len(Request.ClientCertificate(&quot;Subject&quot;)) = 0 Response.Write(&quot;No client certificate was presented&quot;)
End if
%&gt; </pre><p>下面的示例获取发布客户端验证的公司的公用名。</p><pre>&lt;%= Request.ClientCertificate(&quot;IssuerCN&quot;) %&gt; </pre><p>下面的示例检查客户端验证主题的组织名。</p><pre>&lt;% 
If (Request.ClientCertificate(&quot;Subject&quot;)=&quot;Msft&quot;) Response.Write(&quot;Good Choice!&quot;)
End if
%&gt; </pre><p>下面的示例显示客户端验证何时到期。</p><pre>This certification will expire on 
&lt;%= Request.ClientCertificate(&quot;ValidUntil&quot;) %&gt; </pre><p>下面的示例使用 <code>Flags</code> 关键字测试客户端验证的发布者是不是已知的。第一行的 include 命令使脚本可使用已命名标志 <code>ceUnrecognizedIssuer</code>。</p> 
<pre>&lt;!--#include file=&quot;cervbs.inc&quot; --&gt;&lt;%
If Request.ClientCertificate(&quot;Flags&quot;) and ceUnrecognizedIssuer then Response.Write &quot;Unrecognized issuer&quot;End If
%&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Request 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_Cookies_Request"><b>Cookies</b></a>、<a href="#_Form"><b>Form</b></a>、<a href="#_QueryString"><b>QueryString</b></a>、<a href="#_ServerVariables"><b>ServerVariables</b></a> </p><hr class="iis" size="1"><font face="宋体, 宋体, 宋体"><h2><a name="_contenttype"></a>ContentType</h2><p><b>ContentType</b> 属性指定响应的 HTTP 内容类型。如果未指定 <b>ContentType</b>，默认为 text/HTML。</p> 
<h4>语法</h4><pre><b>Response.ContentType </b>[<b>=</b> <i>ContentType </i>] </pre><h4>参数</h4><dl><dt><i>ContentType</i></dt><dd>描述内容类型的字符串。该字符串通常被格式化为类型/子类型，其中类型是常规内容范畴而子类为特定内容类型。有关支持内容类型的完整列表，请参阅 Web 浏览器文档或当前的 HTTP 规格说明。</dd> 
</dl><h4>示例</h4><p>下面的示例将内容类型设置为 Channel Definition Format（CDF）。</p> 
<pre>&lt;% Response.ContentType = &quot;application/x-cdf&quot; %&gt; </pre><p>下面的示例将 <b>ContentType</b> 属性设置为其他的常见值。</p> 
<pre>&lt;% Response.ContentType = &quot;text/HTML&quot; %&gt;&lt;% Response.ContentType = &quot;image/GIF&quot; %&gt;&lt;% Response.ContentType = &quot;image/JPEG&quot; %&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_end"></a>End</h2><p><b>End </b>方法使 Web 服务器停止处理脚本并返回当前结果。文件中剩余的内容将不被处理。</p> 
<h4>语法</h4><pre><b>Response.End </b></pre><h4>注释</h4><p>如果 <b>Response.Buffer</b> 已设置为 TRUE，则调用 <b>Response.End</b> 将缓冲输出。如果不希望将输出返回给用户，应调用</p> 
<pre>&lt;% 
Response.Clear
Response.End
%&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_Buffer"><b>Buffer</b></a>、<a href="#_Clear"><b>Clear</b></a> </p><hr class="iis" size="1"><h2><a name="_servervariables"></a>ServerVariables</h2><p><b>ServerVariables </b>集合检索预定的环境变量。</p><h4>语法</h4><pre><b>Request.ServerVariables (</b><i>server environment</i> <i>variable</i><b>) </b></pre><h4>参数</h4><dl><dt><i>服务器环境变量</i> </dt><dd>指定要检索的服务器环境变量名。可以使用下面列出的值。<table><tr valign=top><td><b>变量</b></td><td><b>说明</b></td></tr><tr valign=top><td>ALL_HTTP</td><td>客户端发送的所有 HTTP 标题文件。</td> 
</tr><tr valign=top><td>ALL_RAW</td><td>检索未处理表格中所有的标题。ALL_RAW 和 ALL_HTTP 不同，ALL_HTTP 在标题文件名前面放置 HTTP_ prefix，并且标题名称总是大写的。使用 ALL_RAW 时，标题名称和值只在客户端发送时才出现。 </td> 
</tr><tr valign=top><td>APPL_MD_PATH</td><td>检索 ISAPI DLL 的 (WAM) Application 的元数据库路径。</td> 
</tr><tr valign=top><td>APPL_PHYSICAL_PATH</td><td>检索与元数据库路径相应的物理路径。IIS 通过将 APPL_MD_PATH 转换为物理（目录）路径以返回值。</td> 
</tr><tr valign=top><td>AUTH_PASSWORD</td><td>该值输入到客户端的鉴定对话中。只有使用基本鉴定时，该变量才可用。 </td></tr><tr valign=top><td>AUTH_TYPE</td><td>这是用户访问受保护的脚本时，服务器用于检验用户的验证方法。</td></tr><tr valign=top><td>AUTH_USER</td><td>未被鉴定的用户名。 </td></tr><tr valign=top><td>CERT_COOKIE</td><td>客户端验证的唯一 ID，以字符串方式返回。可作为整个客户端验证的签字。</td> 
</tr><tr valign=top><td>CERT_FLAGS</td><td>如有客户端验证，则 bit0 为 1。<p> 
如果客户端验证的验证人无效（不在服务器承认的 CA 列表中），bit1 被设置为 1。</p> 
</td></tr><tr valign=top><td>CERT_ISSUER</td><td>用户验证中的颁布者字段（O=MS，OU=IAS，CN=user name，C=USA）。</td> 
</tr><tr valign=top><td>CERT_KEYSIZE</td><td>安全套接字层连接关键字的位数，如 128。</td> 
</tr><tr valign=top><td>CERT_SECRETKEYSIZE</td><td>服务器验证私人关键字的位数。如 1024。</td> 
</tr><tr valign=top><td>CERT_SERIALNUMBER</td><td>用户验证的序列号字段。</td></tr><tr valign=top><td>CERT_SERVER_ISSUER</td><td>服务器验证的颁发者字段。</td></tr><tr valign=top><td>CERT_SERVER_SUBJECT</td><td>服务器验证的主字段。</td></tr><tr valign=top><td>CERT_SUBJECT</td><td>客户端验证的主字段。</td></tr><tr valign=top><td>CONTENT_LENGTH</td><td>客户端发出内容的长度。 </td></tr><tr valign=top><td>CONTENT_TYPE</td><td>内容的数据类型。同附加信息的查询一起使用，如 HTTP 查询 GET、 POST <b></b>和 PUT。</td> 
</tr><tr valign=top><td>GATEWAY_INTERFACE</td><td>服务器使用的 CGI 规格的修订。格式为 CGI/revision。</td> 
</tr><tr valign=top><td>HTTP_&lt;<i>HeaderName</i>&gt;</td><td><i>HeaderName</i> 存储在标题文件中的值。未列入该表的标题文件必须以 HTTP_ 作为前缀，以使 <b>ServerVariables</b> 集合检索其值。<p> 
<b>注意</b> 服务器将 <i>HeaderName</i> 中的下划线（_）解释为实际标题中的破折号。例如，如果您指定 HTTP_MY_HEADER，服务器将搜索以 MY-HEADER 为名发送的标题文件。 </p> 
</td></tr><tr valign=top><td>HTTPS</td><td>如果请求穿过安全通道（SSL），则返回 ON。如果请求来自非安全通道，则返回 OFF。</td> 
</tr><tr valign=top><td>HTTPS_KEYSIZE</td><td>安全套接字层连接关键字的位数，如 128。</td> 
</tr><tr valign=top><td>HTTPS_SECRETKEYSIZE</td><td>服务器验证私人关键字的位数。如 1024。</td> 
</tr><tr valign=top><td>HTTPS_SERVER_ISSUER</td><td>服务器验证的颁发者字段。</td></tr><tr valign=top><td>HTTPS_SERVER_SUBJECT</td><td>服务器验证的主字段。</td></tr><tr valign=top><td>INSTANCE_ID</td><td>文本格式 IIS 实例的 ID。如果实例 ID 为 1，则以字符形式出现。使用该变量可以检索请求所属的（元数据库中）Web 服务器实例的 ID。</td> 
</tr><tr valign=top><td>INSTANCE_META_PATH</td><td>响应请求的 IIS 实例的元数据库路径。</td> 
</tr><tr valign=top><td>LOCAL_ADDR</td><td>返回接受请求的服务器地址。如果在绑定多个 IP 地址的多宿主机器上查找请求所使用的地址时，这条变量非常重要。</td> 
</tr><tr valign=top><td>LOGON_USER</td><td>用户登录 Windows NT&reg; 的帐号。</td> 
</tr><tr valign=top><td>PATH_INFO</td><td>客户端提供的额外路径信息。可以使用这些虚拟路径和 PATH_INFO 服务器变量访问脚本。如果该信息来自 URL，在到达 CGI 脚本前就已经由服务器解码了。</td> 
</tr><tr valign=top><td>PATH_TRANSLATED</td><td>PATH_INFO 转换后的版本，该变量获取路径并进行必要的由虚拟至物理的映射。</td> 
</tr><tr valign=top><td>QUERY_STRING</td><td>查询 HTTP 请求中问号（?）后的信息。 </td> 
</tr><tr valign=top><td>REMOTE_ADDR</td><td>发出请求的远程主机的 IP 地址。 </td> 
</tr><tr valign=top><td>REMOTE_HOST</td><td>发出请求的主机名称。如果服务器无此信息，它将设置为空的 MOTE_ADDR 变量。</td> 
</tr><tr valign=top><td>REMOTE_USER</td><td>用户发送的未映射的用户名字符串。该名称是用户实际发送的名称，与服务器上验证过滤器修改过后的名称相对。</td></tr><tr valign=top><td>REQUEST_METHOD</td><td>该方法用于提出请求。相当于用于 HTTP 的 GET、HEAD、POST 等等。</td> 
</tr><tr valign=top><td>SCRIPT_NAME</td><td>执行脚本的虚拟路径。用于自引用的 URL。</td> 
</tr><tr valign=top><td>SERVER_NAME</td><td>出现在自引用 UAL 中的服务器主机名、DNS 化名或 IP 地址。</td> 
</tr><tr valign=top><td>SERVER_PORT</td><td>发送请求的端口号。</td></tr><tr valign=top><td>SERVER_PORT_SECURE</td><td>包含 0 或 1 的字符串。如果安全端口处理了请求，则为 1，否则为 0。</td> 
</tr><tr valign=top><td>SERVER_PROTOCOL</td><td>请求信息协议的名称和修订。格式为 <i>protocol</i>/<i>revision</i> 。</td> 
</tr><tr valign=top><td>SERVER_SOFTWARE</td><td>应答请求并运行网关的服务器软件的名称和版本。格式为 <i>name</i>/<i>version</i> 。</td> 
</tr><tr valign=top><td>URL </td><td>提供 URL 的基本部分。</td> 
</tr></table><br></dd></dl><h4>注释</h4><p>如果客户端发送的标题文件在上述表格中找不到，可以在调用 <b>Request.ServerVariables</b> 中给标题文件名加上 HTTP_ 的前缀以检索其值。例如，如果客户端发送标题文件</p> 
<pre>SomeNewHeader:SomeNewValue </pre><p>您可以通过使用下面的语法检索 <code>SomeNewValue</code> </p> 
<pre>&lt;% Request.ServerVariables(&quot;HTTP_SomeNewHeader&quot;) %&gt; </pre><p>您可使用重述符以循环遍历所有的服务器变量名。例如，使用下面的脚本打印出所有的服务器名。</p><pre>&lt;TABLE&gt;&lt;TR&gt;&lt;TD&gt;&lt;B&gt;Server Variable&lt;/B&gt;&lt;/TD&gt;&lt;TD&gt;&lt;B&gt;Value&lt;/B&gt;&lt;/TD&gt;&lt;/TR&gt;&lt;% For Each name In Request.ServerVariables %&gt; 
&lt;TR&gt;&lt;TD&gt; &lt;%= name %&gt; &lt;/TD&gt;&lt;TD&gt; &lt;%= Request.ServerVariables(name) %&gt; &lt;/TD&gt;&lt;/TR&gt;&lt;/TABLE&gt;&lt;% Next %&gt; </pre><h4>示例</h4><p>下面的例子使用 <b>Request</b> 对象显示一些服务器变量。</p> 
<pre>&lt;HTML&gt;&lt;!-- This example displays the content of several ServerVariables. --&gt; 
ALL_HTTP server variable = 
&lt;%= Request.ServerVariables(&quot;ALL_HTTP&quot;) %&gt; &lt;BR&gt;CONTENT_LENGTH server variable = 
&lt;%= Request.ServerVariables(&quot;CONTENT_LENGTH&quot;) %&gt; &lt;BR&gt; 
CONTENT_TYPE server variable = 
&lt;%= Request.ServerVariables(&quot;CONTENT_TYPE&quot;) %&gt; &lt;BR&gt;QUERY_STRING server variable = 
&lt;%= Request.ServerVariables(&quot;QUERY_STRING&quot;) %&gt; &lt;BR&gt; 
SERVER_SOFTWARE server variable = 
&lt;%= Request.ServerVariables(&quot;SERVER_SOFTWARE&quot;) %&gt; &lt;BR&gt; 
&lt;/HTML&gt; </pre><p>下一个示例使用 <b>ServerVariables </b>集合将服务器名插入一个超文本链接。 </p> 
<pre>&lt;A HREF = &quot;http://&lt;%= Request.ServerVariables(&quot;SERVER_NAME&quot;) %&gt;/scripts/MyPage.asp&quot;&gt;Link to MyPage.asp&lt;/A&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Request Object</b></a> </p> 
<h4>请参阅</h4><p><a href="#_ClientCertificate"><b>ClientCertificate</b></a>, <a href="#_Cookies_Request"><b>Cookies</b></a>, <a href="#_Form"><b>Form</b></a>, <a href="#_QueryString"><b>QueryString</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_expires"></a>Expires</h2><p><b>Expires</b> 属性指定了在浏览器上缓冲存储的页距过期还有多少时间。如果用户在某个页过期之前又回到此页，就会显示缓冲区中的版本。</p><h4>语法</h4><pre><b>Response.Expires </b>[<b>=</b> <i>number</i>] </pre><h4>参数</h4><dl><dt><i>number</i></dt><dd>距过期还有多少分钟。将此参数设置为 0 可使缓存的页立即过期。</dd> 
</dl><h4>注释</h4><p>若此属性在一页上设置了多次，则使用最短的时间。</p><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_ExpiresAbsolute"><b>ExpiresAbsolute</b></a> </p><hr class="iis" size="1"><h2><a name="_expiresabsolute"></a>ExpiresAbsolute</h2><p><b>ExpiresAbsolute</b> 属性指定缓存于浏览器中的页的到期日期和时间。在未到期之前，若用户返回到该页，该缓存的页就显示。如果未指定时间，该主页在当天午夜到期。如果未指定日期，则该主页在脚本运行当天的指定时间到期。</p><h4>语法</h4><pre><b>Response.ExpiresAbsolute </b>[<b>=</b> [<i>date</i>] [<i>time</i>]] </pre><h4>参数</h4><dl><dt><i>date</i></dt><dd>指定页的到期日期。该值在符合 RFC-1123 日期格式的到期标题中发送。<br> 
</dd><dt><i>time</i></dt><dd>指定页的到期时间。该值在到期标题发送之前转化为 GMT 时间。</dd> 
</dl><h4>注释</h4><p>如果该属性在页中被多次设置，则以最早到期的日期和时间为准。</p><h4>示例</h4><p>以下示例指定页在 1996 年 5 月 31 日下午 1:30 分 15 秒到期。 </p> 
<pre>&lt;% Response.ExpiresAbsolute=#May 31,1996 13:30:15# %&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_Expires"><b>Expires</b></a> </p><hr class="iis" size="1"><h2><a name="_flush"></a>Flush</h2><p><b>Flush </b>方法立即发送缓冲区中的输出。如果未将 <b>Response.Buffer </b>设置为 TRUE，则该方法将导致运行时错误。</p> 
<h4>语法</h4><pre><b>Response.Flush </b></pre><h4>注释</h4><p>如果在 ASP 页上调用 <b>Flush</b> 方法，则服务器将响应该页上保持活动的请求。</p> 
<h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_form"></a>Form</h2><p><b>Form </b>集合通过使用 POST 方法的表格检索邮送到 HTTP 请求正文中的表格元素的值。</p> 
<h4>语法</h4><pre><b>Request.Form(</b><i>element</i><b>)</b>[<b>(</b><i>index</i><b>)</b>|<b>.Count</b>] </pre><h4>参数</h4><dl><dt><i>element</i></dt><dd>指定集合要检索的表格元素的名称。<br></dd><dt><i>index</i></dt><dd>可选参数，使用该参数可以访问某参数中多个值中的一个。它可以是 1 到 <b>Request.Form(</b><i>parameter</i><b>).Count</b> 之间的任意整数。</dd> 
</dl><h4>注释</h4><p><b>Form</b> 集合按请求正文中参数的名称来索引。<b>Request.Form(</b><i>element</i><b>) </b> 的值是请求正文中所有 <i>element</i> 值的数组。通过调用 <b>Request.Form(</b><i>element</i><b>).Count</b> 来确定参数中值的个数。如果参数未关联多个值，则计数为 1。如果找不到参数，计数为 0 。</p> 
<p>要引用有多个值的表格元素中的单个值，必须指定 <i>index</i> 值。<i>index</i> 参数可以是从 1 到 <b>Request.Form(</b><i>element</i><b>).Count</b> 中的任意数字。如果引用多个表格参数中的一个，而未指定 <i>index</i> 值，返回的数据将是以逗号分隔的字符串。</p> 
<p>在使用 <b>Request.Form</b> 参数时，Web 服务器将分析 HTTP 请求正文并返回指定的数据。如果应用程序需要未分析的表格数据，可以通过调用不带参数的 <b>Request.Form</b> 访问该数据。</p> 
<p>使用重述符可以遍历表格请求中的所有数据值。例如，用户通过指定两个值填写表格，<code>Chocolate</code> 和 <code>Butterscotch</code>。对于 <code>FavoriteFlavor</code> 参数，您可以使用下面的脚本检索这些值。</p> 
<pre>&lt;%
For Each item In Request.Form(&quot;FavoriteFlavor&quot;) Response.Write item &amp; &quot;&lt;BR&gt;&quot;Next
%&gt; </pre><p>上述脚本显示如下。</p><pre>Chocolate
Butterscotch </pre><p>使用 <b>For...Next </b>循环可以生成同样的输出，如下列脚本所示。</p> 
<pre>&lt;%
For i = 1 To Request.Form(&quot;FavoriteFlavor&quot;).Count Response.Write Request.Form(&quot;FavoriteFlavor&quot;)(i) &amp; &quot;&lt;BR&gt;&quot;Next
%&gt; </pre><p>使用该复述符可以显示参数名。如下列脚本所示。</p><pre>&lt;% For Each x In Request.Form %&gt;Request.Form( &lt;%= x %&gt; ) = &lt;%= Request.Form(x) %&gt; &lt;BR&gt;&lt;% Next %&gt; </pre><p>该脚本在浏览器上显示下列信息。</p><pre>FavoriteFlavor = Chocolate
FavoriteFlavor = Butterscotch </pre><h4>示例</h4><p>请考虑下列表格。</p><pre>&lt;FORM ACTION = &quot;/scripts/submit.asp&quot; METHOD = &quot;post&quot;&gt;&lt;P&gt;Your first name: &lt;INPUT NAME = &quot;firstname&quot; SIZE = 48&gt;&lt;P&gt;What is your favorite ice cream flavor: &lt;SELECT NAME = &quot;flavor&quot;&gt;&lt;OPTION&gt;Vanilla 
&lt;OPTION&gt;Strawberry 
&lt;OPTION&gt;Chocolate 
&lt;OPTION&gt;Rocky Road&lt;/SELECT&gt;&lt;p&gt;&lt;INPUT TYPE = SUBMIT&gt;&lt;/FORM&gt; </pre><p>下列的请求正文可以从该脚本中发送。</p><pre>firstname=James&amp;flavor=Rocky+Road </pre><p>可以使用下面的脚本。</p><pre>Welcome, &lt;%= Request.Form(&quot;firstname&quot;) %&gt;. 
Your favorite flavor is &lt;%= Request.Form(&quot;flavor&quot;) %&gt;. </pre><p>下面的输出就是结果。</p><pre>Welcome, James. Your favorite flavor is Rocky Road. </pre><p>如果使用下面的脚本</p><pre>The unparsed form data is: &lt;%= Request.Form %&gt; </pre><p>结果为</p><pre>The unparsed form data is: firstname=James&amp;flavor=Rocky+Road </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Request Object</b></a> </p> 
<h4>请参阅</h4><p><a href="#_ClientCertificate"><b>ClientCertificate</b></a>, <a href="#_Cookies_Request"><b>Cookies</b></a>, <a href="#_QueryString"><b>QueryString</b></a>, <a href="#_ServerVariables"><b>ServerVariables</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_isclientconnected"></a>IsClientConnected</h2><p><b>IsClientConnected</b> 属性只读，它指示自上次调用 <b>Response.Write</b> 之后，客户端是否与服务器相连。</p> 
<h4>语法</h4><pre><b>Response.IsClientConnected ( ) </b></pre><h4>注释</h4><p>该属性允许用户在客户端与服务器没有连接的情况下有更多的控制。例如，在从客户端提出请求起到服务器作出响应，其间要用去很长一段时间的情况下，这就可能有助于确保在继续处理脚本之前客户端仍是连通的。</p><h4>示例</h4><pre>&lt;% 
'check to see if the client is connected
If Not Response.IsClientConnected Then  'get the sessionid to send to the shutdown function Shutdownid = Session.SessionID
'perform shutdown processing Shutdown(Shutdownid)  End If
%&gt;</pre><h4>应用于 </h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_pics"></a>PICS</h2><p><b>PICS</b> 属性向响应标题的 pics 标签字段添加值。</p> 
<h4>语法</h4><pre><b>Response.PICS</b>(<i>PICSLabel</i>) </pre><h4>参数</h4><dl><dt><i>PICSLabel</i></dt><dd>经适当格式化的 PICS 标签字符串。由 <i>PICSLabel</i> 指定的值将被添加到响应标题中的 PICS 标签字段之后。 </dd> 
</dl><h4>示例</h4><p>对于包含</p><pre>&lt;% 
Response.PICS(&quot;(PICS-1.1 <u>&lt;http://www.rsac.org/ratingv01.html&gt;</u> labels on &quot; &amp; chr(34) &amp; &quot;1997.01.05T08:15-0500&quot; &amp; chr(34) &amp; &quot; until&quot; &amp; chr(34) &amp; &quot;1999.12.31T23:59-0000&quot; &amp; chr(34) &amp; &quot; ratings (v 0 s 0 l 0 n 0))&quot;) 
%&gt; 
</pre><p>的 .asp 文件，将添加以下标题：</p> 
<pre>PICS-label:(PICS-1.1 <u>&lt;http://www.rsac.org/ratingv01.html&gt;</u> labels on &quot;1997.01.05T08:15-0500&quot; until &quot;1999.12.31T23:59-0000&quot; ratings (v 0 s 0 l 0 n 0))
</pre><h4>注释</h4><p><b>PICS</b> 属性在标题中插入任何字符串，不管它是否表示有效的 PICS 标签。 </p> 
<p>若一个单页包含多个包含 <b>Response.PICS</b> 的标记，则每个实例代替上一个 PICS 标签设置的 PICS 标签。结果是，PICS 将被设置为页中上一个 <b>Response.PICS </b> 实例所指定的值。</p> 
<p>由于 PICS 标签包含引号，所以必须用 <code>&quot; &amp; chr(34) &amp; &quot;</code> 替换每个引号。 </p> 
<h4>应用</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_querystring"></a>QueryString</h2><p><b>QueryString</b> 集合检索 HTTP 查询字符串中变量的值。HTTP 查询字符串由问号 (?) 后的值指定。几个不同的进程都可以生成查询字符串。如，anchor 标记</p> 
<p>&lt;A HREF= &quot;example?string=this is a sample&quot;&gt;string sample&lt;/A&gt;</p> 
<p>生成值为 &quot;this is a sample&quot; 的变量名字符串。通过发送表格或由用户在其浏览器的地址框中键入查询也可以生成查询字符串。</p> 
<h4>语法</h4><pre><b>Request.QueryString(</b><i>variable</i><b>)</b>[<b>(</b><i>index</i><b>)</b>|<b>.Count</b>] </pre><h4>参数</h4><dl><dt><i>variable</i></dt><dd>在 HTTP 查询字符串中指定要检索的变量名。<br> 
</dd><dt><i>index</i></dt><dd>这是一个可选参数，可以用来检索 <i>variable</i> 的多个值中的某一个值。这可以是从 1 到 <b>Request.QueryString(</b><i>variable</i><b>).Count</b> 之间的任何整数。</dd> 
</dl><h4>注释</h4><p><b>QueryString</b> 集合是在 <b>ServerVariables</b> 集合中 QUERY_STRING 变量的分析版本 。它可以让您以名称检索 QUERY_STRING 变量。<b>Request.QueryString (</b><i>参数</i><b>)</b> 的值是出现在 QUERY_STRING 中所有<i>参数</i> 的值的数组。通过调用 <b>Request.QueryString(</b><i>parameter</i><b>).Count</b> 可以确定参数有多少个值。如果变量未关联多个数据集，则计数为 1。如果找不到变量，计数为 0。</p> 
<p>要在多个数据集合的一个中引用 <b>QueryString</b> 变量，请指定 <i>index</i> 的值。<i>index</i> 参数可以是 1 到 <b>Request.QueryString(</b><i>variable</i><b>).Count</b> 中任意值。如果没有指定 <i>index</i> 的值，引用多个 <b>QueryString</b> 变量中的某个变量时，返回的数据是逗号分隔的字符串。</p> 
<p>在 <b>Request.QueryString</b> 中使用参数时，服务器分析发送给请求的参数，并返回指定的数据。如果应用程序需要未分析的 <b>QueryString</b> 数据，可以通过调用不带参数的 <b>Request.QueryString</b> 检索到这个数据。</p> 
<p>可以使用复述符在查询字符串中循环遍历所有的数据值。例如，如果发送以下的请求</p><pre>http://NAMES.ASP?Q=Fred&amp;Q=Sally </pre><p>而且 <code>Names.asp</code> 包含下面的脚本，</p> 
<pre>---NAMES.ASP---
&lt;%
For Each item In Request.QueryString(&quot;Q&quot;) Response.Write item &amp; &quot;&lt;BR&gt;&quot;Next
%&gt; </pre><p><code>Names.asp</code> 将显示如下。</p> 
<pre>Fred
Sally </pre><p>上述脚本也可以用 <b>Count</b> 来写。</p> 
<pre>&lt;%
For I = 1 To Request.QueryString(&quot;Q&quot;).Count Response.Write Request.QueryString(&quot;Q&quot;)(I) &amp; &quot;&lt;BR&gt;&quot;Next
%&gt; </pre><h4>示例</h4><p>客户端请求</p><pre>/scripts/directory-lookup.asp?name=fred&amp;age=22 </pre><p>results in the following QUERY_STRING value. </p><pre>name=fred&amp;age=22. </pre><p><b>QueryString</b> 集合将包含 <code>name</code> 和 <code>age</code>两个成员。那么，您就可以使用下面的脚本。 </p> 
<pre>Welcome, &lt;%= Request.QueryString(&quot;name&quot;) %&gt;. 
Your age is &lt;%= Request.QueryString(&quot;age&quot;) %&gt;. </pre><p>将输出</p><pre>Welcome, Fred. Your age is 22. </pre><p>如果使用下面的脚本</p><pre>The unparsed query string is: &lt;%=Request.QueryString %&gt; </pre><p>将输出</p><pre>The unparsed query string is: name=fred&amp;age=22 </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Request 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_ClientCertificate"><b>ClientCertificate</b></a>、<a href="#_Cookies_Request"><b>Cookies</b></a>、<a href="#_Form"><b>Form</b></a>、<a href="#_ServerVariables"><b>ServerVariables</b></a> </p><hr class="iis" size="1"><h2><a name="_redirect"></a>Redirect</h2><p><b>Redirect</b> 方法使浏览器尝试连接到其他 URL。</p> 
<h4>语法</h4><pre><b>Response.Redirect</b> <i>URL </i></pre><h4>参数</h4><dl><dt><i>URL</i></dt><dd>浏览器重定向到的统一资源定位符 (URL)。 
</dd></dl><h4>注释</h4><p>任何在页中显式设置的响应正文内容都将被忽略。然而，此方法不向客户端发送该页设置的其他 HTTP 标题。将产生一个将重定向 URL 作为链接包含的自动响应正文。<b>Redirect</b> 方法发送下列显式标题，其中 URL 是传递给该方法的值。</p> 
<pre>HTTP/1.0 302 Object Moved
Location <i>URL </i></pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_cookies_request"></a>Cookies</h2><p><b>Cookies </b> 集合允许用户检索在 HTTP 请求中发送的 cookie 的值。 </p> 
<h4>语法</h4><pre><b>Request.Cookies(</b><i>cookie</i><b>)</b>[<b>(</b><i>key</i><b>)</b>|<b>.</b><i>attribute</i>] </pre><h4>参数 </h4><dl><dt><i>cookie</i></dt><dd>指定要检索其值的 cookie。<br> 
</dd><dt><i>key</i></dt><dd>可选参数，用于从 cookie 字典中检索子关键字的值。 <br> 
</dd><dt><i>attribe</i></dt><dd>指定 cookie 自身的有关信息。其属性参数如下：<table> 
<tr valign=top><td><b>名称</b></td><td><b>说明</b></td></tr><tr valign=top><td><b>HasKeys</b></td><td>只读。指定 cookie 是否包含关键字。 
</td></tr></table><br></dd></dl><h4>注释</h4><p>可以通过包含一个 <i>key</i> 值来访问 cookie 字典的子关键字。如果访问 cookie 字典时未指定 <i>key</i>，则所有关键字都会作为单个查询字符串返回。例如，如果 MyCookie<code> </code>有两个关键字, <code>First </code><i> </i> 和<code> Second </code>，而在调用 <b>Request.Cookies</b>时并未指定其中任何一个关键字，那么将返回下列字符串。</p> 
<pre>First=firstkeyvalue&amp;Second=secondkeyvalue </pre><p>如果客户端浏览器发送了两个同名的 cookie，那么 <b>Request.Cookie </b>将返回其中路径结构较深的一个。例如，如果有两个同名的的 cookie，但其中一个的路径属性为 /www/ 而另一个为 /www/home/，客户端浏览器同时将两个 cookie 都发送到 /www/home/ 目录中，那么 <b>Request.Cookie </b>将只返回第二个 cookie。</p> 
<p>要确定某个 cookie 是不是 cookie 字典（cookie 有否有关键字），可使用下列脚本。</p> 
<pre>&lt;%= Request.Cookies(&quot;myCookie&quot;).HasKeys %&gt; </pre><p>如果 <code>myCookie</code> 是一个 cookie 字典，则前面的赋值为 TRUE。否则，为 FALSE。</p> 
<p>可以通过循环遍历 <b>Cookies </b>集合中的所有 cookie 或 cookie 中的所有关键字。但是，通过关键字在没有关键字的 cookie 上遍历将不产生任何输出。使用 <b>HasKeys</b> 语法先检查一下 cookie 是否有关键字，可以避免这种情况。下面的例子对此进行演示。</p> 
<pre>&lt;% 
'Print out the entire cookie collection.
For Each cookie in Request.Cookies If Not cookie.HasKeys Then  'Print out the cookie string 
%&gt;  &lt;%= cookie %&gt; = &lt;%= Request.Cookies(cookie)%&gt;&lt;%
Else 'Print out the cookie collection For Each key in Request.Cookies(cookie)
%&gt; &lt;%= cookie %&gt; (&lt;%= key %&gt;) = &lt;%= Request.Cookies(cookie)(key)%&gt;&lt;% Next 
End If
Next 
%&gt; </pre><h4>示例 </h4><p>下面的例子打印 Web 页中的 <code>myCookie</code> 的值。</p> 
<pre>这是名为 myCookie 的 cookie 值: 
&lt;%= Request.Cookies(&quot;myCookie&quot;) %&gt; </pre><h4> 应用于 </h4><p><a href="#_Request_object"><b>Request 对象</b></a> </p> 
<h4>请参阅 </h4><p><a href="#_ClientCertificate"><b>ClientCertificate</b></a>、<a href="#_Form"><b>Form</b></a>、<a href="#_QueryString"><b>QueryString</b></a>、<a href="#_ServerVariables"><b>ServerVariables</b></a> </p><hr class="iis" size="1"><h2><a name="_request_object"></a>Request 对象</h2> 
<p><b>Request </b>对象在 HTTP 请求期间，检索客户端浏览器传递给服务器的值 。</p> 
<h4>语法</h4><pre><b>Request</b>[<b>.</b><i>collection|property|method</i>]<b>(</b><i>variable</i><b>) </b></pre><h4>集合</h4><table><tr valign=top><td><a href="#_ClientCertificate"><b>ClientCertificate</b></a> </td><td>存储在发送到 HTTP 请求中客户端证书中的字段值。</td> 
</tr><tr valign=top><td><a href="#_Cookies_Request"><b>Cookies</b></a></td><td>HTTP 请求中被发送的 cookie 的值。 </td> 
</tr><tr valign=top><td><a href="#_Form"><b>Form</b></a></td><td>HTTP 请求正文中表格元素的值。 </td> 
</tr><tr valign=top><td><a href="#_QueryString"><b>QueryString</b></a></td><td>HTTP 中查询字符串中变量的值。 </td> 
</tr><tr valign=top><td><a href="#_ServerVariables"><b>ServerVariables</b></a></td><td>预定的环境变量的值。 </td></tr></table><br><h4>属性</h4><table><tr valign=top><td><a href="#_TotalBytes"><b>TotalBytes</b></a></td><td>只允许读。指定客户端在请求正文中发送的字节总数。</td></tr></table><br><h4>方法</h4><table><tr valign=top><td><a href="#_BinaryRead"><b>BinaryRead</b></a></td><td>检索从客户端发送到服务器作为 POST 请求的一部分的数据。</td> 
</tr></table><br><p>变量参数是一些字符串，这些字符串指定要从集合中检索的项目，或作为方法或属性的输入。有关 <i>variable</i> 参数的详细信息，请参阅各集合说明。</p> 
<h4>注释</h4><p>如果指定的变量不是上述的五个集合中的一个，<b>Request</b> 对象返回 EMPTY。</p><p>可以通过调用 <b>Request(</b><i>variable</i><b>)</b> 直接使用所有的变量，而不需要集合的名称。正因为这样，Web 服务器可以按照下面的顺序搜索集合。 
<ol><li><b>QueryString</b><br><br></li><li><b>Form</b><br><br></li><li><b>Cookies</b><br><br></li><li><b>ClientCertificate</b><br><br></li><li><b>ServerVariables</b></li></ol><p>如果同名的变量出现在多个集合中，<b>Request</b> 对象返回遇到的第一个实例。 </p><p>我们建议在涉及 <b>ServerVariables</b> 集合的成员时使用全名。例如，不用 <b>Request</b>.(AUTH_USER) 而用<b>Request.ServerVariables</b>(AUTH_USER) 。</p><h4>请参阅</h4><p><a href="#_Request_object"><b>Response </b>对象</a> </p><hr class="iis" size="1"><h2><a name="_cookies_response"></a>Cookies</h2><p><b>Cookies </b>集合设置 cookie 的值。若指定的 cookie 不存在，则创建它。若存在，则设置新的值并且将旧值删去。</p> 
<h4>语法</h4><pre><b>Response.Cookies(</b><i>cookie</i><b>)</b>[<b>(</b><i>key</i><b>)</b>|<b>.</b><i>attribute</i>]<b> =</b> <i>value</i> </pre><h4>参数</h4><dl><dt><i>cookie</i></dt><dd>cookie 的名称。<br> 
</dd><dt><i>key</i></dt><dd>可选参数。如果指定了 <i>key</i>，则 cookie 就是一个字典，而 <i>key</i> 将被设置为 <i>value</i>。<br> 
</dd><dt><i>attribute</i></dt><dd>指定 cookie 自身的有关信息。attribute 参数可以是下列之一：<table> 
<tr valign=top><td><b>名称</b></td><td><b>说明</b></td></tr><tr valign=top><td>Domain</td><td>只允许写。若被指定，则 cookie 将被发送到对该域的请求中去。</td> 
</tr><tr valign=top><td>Expires</td><td>只允许写。cookie 的过期日期。为了在会话结束后将 cookie 存储在客户端磁盘上，必须设置该日期。若此项属性的设置未超过当前日期，则在任务结束后 cookie 将到期。</td> 
</tr><tr valign=top><td>HasKeys</td><td>只允许读。指定 cookie 是否包含关键字。</td> 
</tr><tr valign=top><td>Path </td><td>只允许写。若被指定，则 cookie 将只发送到对该路径的请求中。如果未设置该属性，则使用应用程序的路径。</td> 
</tr><tr valign=top><td>Secure</td><td>只允许写。指定 cookie 是否安全。</td> 
</tr></table><br><br></dd><dt><i>Value</i></dt><dd>指定分配给 <i>key </i>或 <i>attribute</i> 的值。</dd> 
</dl><h4>注释</h4><p>如果创建了一个带有关键字的 cookie，如下列脚本所示，</p> 
<pre>&lt;% 
Response.Cookies(&quot;mycookie&quot;)(&quot;type1&quot;) = &quot;sugar&quot;Response.Cookies(&quot;mycookie&quot;)(&quot;type2&quot;) = &quot;ginger snap&quot;%&gt; </pre><p>则此标题将被发送出去。</p><pre>Set-Cookie:MYCOOKIE=TYPE1=sugar&amp;TYPE2=ginger+snap </pre><p>如果在指定 <code>myCookie</code><i> </i>时不指定关键字，将破坏 <code>type1</code><i> </i>和 <code>type2</code>。如下面示例所示。</p> 
<pre>&lt;% Response.Cookies(&quot;myCookie&quot;) = &quot;chocolate chip&quot; %&gt; </pre><p>在前面的示例中，关键字 <code>type1</code> 和 <code>type2</code> 被破坏且其值也被删除。<code>myCookie</code> cookie 只有 <code>chocolate chip</code> 的值。 </p> 
<p>反之，如果您用一个关键字调用 cookie，就会毁坏 cookie 包含的任何无关键字的值。例如，如果在上述代码后，用下面的语句调用 <b>Response.Cookies</b>，</p> 
<pre>&lt;% Response.Cookies(&quot;myCookie&quot;)(&quot;newType&quot;) = &quot;peanut butter&quot; %&gt; </pre><p>则 <code>chocolate chip</code> 的值将被删除且 <code>newType</code> 会被设置为 <code>peanut butter</code>。</p> 
<p>要确定 cookie 是否有关键字，可使用下面的语法。</p> 
<pre>&lt;%= Response.Cookies(&quot;myCookie&quot;).HasKeys %&gt; </pre><p>如果 <code>myCookie</code> 是一个 cookie 字典，则前面的值为 TRUE。否则，为 FALSE。</p> 
<p>可以通过循环来设置 cookie 的属性。例如，要将所有的 cookie 设置为在一个特定的日期到期，可使用下面的语法。</p> 
<pre>&lt;% 
For Each cookie in Response.Cookies Response.Cookie(cookie).Expires = #July 4, 1997#
Next
%&gt; </pre><p>您可以使用一个循环设置一个集合中的所有 cookie 或一个 cookie 中的所有关键字。然而，循环在 cookie 没有关键字时若被引用将不会执行。为避免这种情况，你可以先使用 <b>.HasKeys</b> 语法检查一个 cookie 是否有关键字。下面的示例对此进行说明。</p> 
<pre>&lt;% 
If Not cookie.HasKeys Then 'Set the value of the cookie  Response.Cookies(cookie) = &quot;&quot;Else 'Set the value for each key in the cookie collection For Each key in Response.Cookies(cookie)  Response.Cookies(cookie)(key) = &quot;&quot; Next key
%&gt; </pre><h4>示例</h4><p>下面的示例说明如何设置 cookie 的值以及如何为其属性赋值。</p> 
<pre>&lt;% 
Response.Cookies(&quot;Type&quot;) = &quot;Chocolate Chip&quot;Response.Cookies(&quot;Type&quot;).Expires = &quot;July 31, 1997&quot;Response.Cookies(&quot;Type&quot;).Domain = &quot;msn.com&quot;Response.Cookies(&quot;Type&quot;).Path = &quot;/www/home/&quot;Response.Cookies(&quot;Type&quot;).Secure = FALSE
%&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_Cookies_Request"><b>Request.Cookies</b></a> </p><hr class="iis" size="1"><h2><a name="_response_object"></a>Response 对象</h2> 
<p>使用 <b>Response </b> 对象可以将输出发送到客户端。</p> 
<h4>语法</h4><pre><b>Response.</b><i>collection</i>|<i>property</i>|<i>method </i></pre><h4>集合</h4><table><tr valign=top><td><a href="#_Cookies_Response"><b> cookie </b></a></td><td>指定 cookie 值。可以使用该集合设置 cookie 的值。 </td> 
</tr></table><br><h4>属性</h4><table><tr valign=top><td><a href="#_Buffer"><b>Buffer</b></a></td><td>表明页输出是否被缓冲。</td></tr><tr valign=top><td><a href="#_CacheControl"><b>CacheControl</b></a></td><td>决定代理服务器是否能缓存 ASP 生成的输出。</td> 
</tr><tr valign=top><td><a href="#_Charset"><b>Charset</b></a></td><td>将字符集的名称添加到内容类型标题中。</td></tr><tr valign=top><td><a href="#_ContentType"><b>ContentType</b></a></td><td>指定响应的 HTTP 内容类型。 </td> 
</tr><tr valign=top><td><a href="#_Expires"><b>Expires</b></a></td><td>在浏览器中缓存的页面超时前，指定缓存的时间。</td></tr><tr valign=top><td><a href="#_ExpiresAbsolute"><b>ExpiresAbsolute</b></a></td><td>指定浏览器上缓存页面超时的日期和时间。</td></tr><tr valign=top><td><a href="#_IsClientConnected"><b>IsClientConnected</b></a></td><td>表明客户端是否与服务器断开。</td></tr><tr valign=top><td><a href="#_pics"><b>Pics</b></a></td><td>将 PICS 标记的值添加到响应的标题的 PICS 标记字段中。</td> 
</tr><tr valign=top><td><a href="#_Status"><b>Status</b></a></td><td>服务器返回的状态行的值。 </td></tr></table><br><h4>方法</h4><table><tr valign=top><td><a href="#_AddHeader"><b>AddHeader</b></a></td><td>从 <i>名称</i> 到 <i>值</i> 设置 HTML 标题。 </td> 
</tr><tr valign=top><td><a href="#_AppendToLog"><b>AppendToLog</b></a></td><td>在该请求的 Web 服务器日志条目后添加字符串。</td> 
</tr><tr valign=top><td><a href="#_BinaryWrite"><b>BinaryWrite</b></a></td><td>将给出信息写入到当前 HTTP 输出中，并且不进行任何字符集转换。</td> 
</tr><tr valign=top><td><a href="#_Clear"><b>Clear</b></a></td><td>清除任何缓冲的 HTML 输出。 </td> 
</tr><tr valign=top><td><a href="#_End"><b>End</b></a></td><td>停止处理 .asp 文件并返回当前的结果。</td> 
</tr><tr valign=top><td><a href="#_Flush"><b>Flush</b></a></td><td>立即发送缓冲的输出。</td></tr><tr valign=top><td><a href="#_Redirect"><b>Redirect</b></a></td><td>将重指示的信息发送到浏览器，尝试连接另一个 URL。</td> 
</tr><tr valign=top><td><a href="#_Write"><b>Write</b></a></td><td>将变量作为字符串写入当前的 HTTP 输出。</td> 
</tr></table><br><h4>请参阅</h4><p><a href="#_Request_object"><b>Request 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_status"></a>Status</h2><p><b>Status </b>属性指定服务器返回的状态行的值。HTTP 规格中定义了 Status 值。</p> 
<h4>语法</h4><pre><b>Response.Status =</b> <i>StatusDescription</i> </pre><h4>参数</h4><dl><dt><i>StatusDescription</i></dt><dd>包含表示状态码的三位数和该代码简短说明的字符串。例如，310 Move Permanently。</dd> 
</dl><h4>注释</h4><p>使用该属性修改服务器返回的状态行。 </p><h4>示例</h4><p>下面示例设置响应状态。</p><pre>&lt;% Response.Status = &quot;401 Unauthorized&quot; %&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<hr class="iis" size="1"><h2><a name="_totalbytes"></a>TotalBytes</h2><p><b>TotalBytes</b> 属性指定客户端在请求正文中发送的总字节数。该属性只允许读。</p><h4>语法</h4><pre><i>Counter</i> <b>= Request.TotalBytes </b></pre><h4>参数</h4><dl><dt><i>Counter</i></dt><dd>指定一个变量来接收客户端在请求中发送的总字节数。</dd></dl><h4>示例</h4><p>以下脚本设置一个等于请求对象中包括的总字节数的变量。</p><pre>&lt;%
Dim bytecount
bytecount = Request.TotalBytes
%&gt;</pre><h4>应用于</h4><p><a href="#_Request_object"><b>Request 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_BinaryRead"><b>BinaryRead</b></a> </p><hr class="iis" size="1"><h2><a name="_write"></a>Write</h2><p><b>Write </b>方法将指定的字符串写到当前的 HTTP 输出。</p> 
<h4>语法</h4><pre><b>Response.Write </b><i>variant </i></pre><h4>参数</h4><dl><dt><i>variant</i></dt><dd>需要写的数据。该参数可以是任何 Visual Basic Scripting Edition 的 VARIANT 数据类型，包括字符、字符串和整数。该值不能包括字符组合 %&gt;，如果需要，可用转义序列 %&gt; 代替。Web 服务器在处理脚本时，将转换这一转义序列。 </dd> 
</dl><h4>示例</h4><p>以下示例用 <b>Response.Write</b> 方法将输出发送到客户端。 </p> 
<pre>I just want to say &lt;% Response.Write &quot;Hello World.&quot; %&gt; 
Your name is: &lt;% Response.Write Request.Form(&quot;name&quot;) %&gt; </pre><p>以下示例将 HTML 标记添加到 Web 页输出。由于 <b>Write </b>方法返回的字符串不包含字符组合 %&gt;，代之的是 %&gt;。以下脚本</p> 
<pre>&lt;% Response.Write &quot;&lt;TABLE WIDTH = 100%&gt;&quot; %&gt; </pre><p>输出</p><pre>&lt;TABLE WIDTH = 100%&gt; </pre><h4>应用于</h4><p><a href="#_Request_object"><b>Response 对象</b></a> </p> 
<h4>请参阅</h4><p><a href="#_BinaryWrite"><b>BinaryWrite</b></a> </p><hr class="iis" size="1"><p align="center"><em><a href="#_/iishelp/common/colegal">&copy; 1997 by Microsoft Corporation. All rights reserved.</a></em></p> 
<center> <A HREF="http://www.51windows.Net">www.51windows.Net</A></center></BODY></HTML>

顶端 Posted: 2005-06-13 14:16 | [楼主]

都市精灵

级别: 勇者侠士

精华: 0
发帖: 128
威望: 130 点
财富: 944 K币
贡献值: 0 点
注册时间:2005-01-08
最后登录:1970-01-01

小中大引用推荐编辑只看复制

支持！太好了

系统提示：这是一个从旧版导入的帖子，如有问题请参照原帖（原帖地址见顶楼）。

顶端 Posted: 2005-12-07 12:20 | 1 楼

	帖子浏览记录版块浏览记录
IECN社区 » ASP/.Net/MSSQL