ASP Quick Reference

Kwamtaron CodeW3C.com. A cika, waje ko anna, domin a fi aiki a kai kai.

Lanararun bazara

ASP asusun da <% kuma %> zuwa. A ta bai wa anna yadda a cikin browser:



<% response.write("Hello World!") %>


ASP 中的默认语言是 VBScript。如需使用其他脚本语言,请在 ASP 页面顶端插入一段语言声明:

<%@ language="javascript" %>


<%
....
%>

表单和用户输入

Request.QueryString 用户收集 method="get" 的表单中的值。从表单通过 GET 发送的信息对所有人都可见(将显示在浏览器的地址栏中),对所发送的数据量也有限制。

Request.Form 用于收集 method="post" 的表单中的值。从表单通过 POST 发送的信息对其他人是不可见,对所发送的数据量没有限制。

ASP Cookies

cookie 常用语识别用户。cookie 是服务器嵌到用户计算机上的小文件。每当相同的计算机通过浏览器请求摸个页面时,也会发送 cookie。

Response.Cookies 命令用于创建 cookie:

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2012"
%>

注释:Response.Cookies 命令必须位于 标签之前!

"Request.Cookies" 命令用于取回 cookie 值:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

引用文件

通过 #include 指令,在服务器执行前,您能够把一个 ASP 文件的内容插入另一个 ASP 文件中。#include 指令用于创建函数、页头、页脚,或多个页面上重复使用的元素。

语法:

<!--#include virtual="somefile.inc"-->

ama

<!--#include file ="somefile.inc"-->

Kamfanin gani za 'virtual' domin sabonin hanyar hanyar don kira hanyar hanyar da /html. Idan a fayil mai sunan 'header.inc' yake a /html, koda yake zai cikakar 'header.inc' na kowane:

<!-- #include virtual ="/html/header.inc" -->

Amfani da kalmomin muhimmanci file don nuna hanyar. Hanyar na iya kaiwa daga kundin wanda zai iya amfani da shi. Idan file na iya raba a cikin html directory, kuma file "header.inc" yana raba a html\headers, code na kaiwa zai kaiwa "header.inc" a file na kaiwa:

<!-- #include file ="headers\header.inc" -->

Amfani da kalmomin muhimmanci file da grammar (..\) don rarraba file na yankin kaiwa.

Global.asa

Global.asa file na iya zama file da za a iya amfani da shi, wanda zai iya raba kowane page na ASP application kuma zai iya raba object declaration, variable da method.

tambayi: Global.asa file zai iya raba a cikin ASP applications root directory, kuma kowane application zai iya raba kawai Global.asa file kanin.

Global.asa file zai iya raba kawai kuma:

  • Application event
  • Session event
  • <object> bayanin yin
  • TypeLibrary 声明
  • #include amanar

Application da Session event

A Global.asa, za a iya saba application ko session object da ba da kuma yana faruwa ne bayan application/session baya, kuma yana faruwa ne bayan application/session baya. Code wanda zai gudanar da lokacin yana aiki yana aiki a event handler.

tambayi: Girmi code a Global.asa file, a ba amfani da <% da %> ba, amfani da sub-program a HTML <script> tag kaiwa:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' some code
end sub
sub Application_OnEnd
  ' some code
end sub
sub Session_OnStart
  ' some code
end sub
sub Session_OnEnd
  ' some code
end sub
</script>

<object> bayanin yin

Girmi <object> tag, wani kuma zai Global.asa girmi object da da session ko application yanki.

tambayi: <object> tag zai <script> tag kaiwa!

语法:

<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......

TypeLibrary 声明

TypeLibrary 是与 COM 对象对应的 DLL 文件的内容容器。通过在 Global.asa 文件中包含对 TypeLibrary 的调用,就能够访问 COM 对象的常量,同时 ASP 代码也能够更好地报告错误。如果您的 Web 应用程序依赖已在类型库中声明了数据类型的 COM 对象,您可以在 Global.asa 中声明该类型库。

语法:


Session 对象

Session 对象用于存储有关用户 session 的信息,或者更改其设置。Session 对象中存储的变量存有关于单个用户的信息,并且能够由一个应用程序中的所有页面进行访问。

集合

  • Contents - 包含所有通过脚本命令追加到 session 的条目
  • StaticObjects - 包含了所有使用 HTML 的 标签追加到 session 的对象
  • Contents.Remove(item/index) - 从 Contents 集合删除一个项目
  • Contents.RemoveAll() - 从 Contents 集合删除全部项目
  • 属性

    • CodePage - 规定显示动态内容时使用的字符集
    • LCID - 设置用于显示动态内容的区域标识符
    • SessionID - Tura ID na session
    • Timeout - Taya ko tura wa session da lokaci na nuna

    方法

    • Abandon - Ci gaba da kowane kwarin da ke cikin session object.

    Kwarin Application

    A kungiyar ASP wadanda ke aiki dona sake hanyar zirga ba a sani da aplikishan. A cikin ASP, kwarin Application yana samun koyar da su yi karkashin yin kama. Dukansu ke kama Application object. Kwarin Application yana da kyauta don da hanyar kuma aiki don sauransu a cikin manyan wasan kwaikwayo na shugaban (masu sauransu) daidai).

    集合

    • Kontentsi - A dace dake gudan gurin ya a dace dake kara gurin zuwa shugaba
    • StaticObjects - 包含所有使用 HTML 的 <object> 标签追加到应用程序中的对象
    • Contents.Remove - 从 Contents 集合中删除一个项目
    • Contents.RemoveAll - 从 Contents 集合中删除所有的项目

    方法

    • Lock - 防止用户修改 Application 对象中的变量
    • Unlock - 允许用户修改 Application 对象中的变量

    Response 对象

    Response 对象用于从服务器将输出发送给用户。

    集合

    Cookies(name) - 设置 cookie 的值。假如不存在,就创建 cookie ,然后设置指定的值。

    属性

    • Buffer - 规定是否缓冲输出。当输出设置缓存时,服务器会阻止向浏览器的响应,直到所有的服务器脚本均被处理,或者直到脚本调用了 Flush 或 End 方法。如果要设置此属性,它应当位于 .asp 文件中的 <html> 标签之前。
    • CacheControl - 设置代理服务器是否可以缓存由 ASP 产生的输出。如果设置为 Public,则代理服务器会缓存页面。
    • Charset(charset_name) - 将字符集的名称追加到 Response 对象中的 content-type 报头。
    • ContentType - 设置 Response 对象的 HTTP 内容类型。(比如 "text/html", "image/gif", "image/jpeg", "text/plain")。默认是 "text/html"
    • Expires - 设置页面在失效前的浏览器缓存时间(分钟)
    • ExpiresAbsolute - 设置浏览器上页面缓存失效的日期和时间
    • IsClientConnected - 指示客户端是否已从服务器断开
    • Pics(pics_label) - 向 response 报头的 PICS 标志追加值
    • Status - 规定由服务器返回的状态行的值

    方法

    • AddHeader(name, value) - 向 HTTP 响应添加新的 HTTP 报头和值
    • AppendToLog string - 向服务器记录项目(server log entry)的末端添加字符串
    • BinaryWrite(data_to_write) - 在没有任何字符转换的情况下直接向输出写数据
    • Clear - 清除已缓冲的输出。使用该方法来处理错误。如果 Response.Buffer 未设置为 true,该方法将产生 run-time 错误
    • End - 停止处理脚本,并返回当前的结果
    • Flush - 立即发送已缓存的输出。如果 Response.Buffer 未设置为 true,该方法将产生 run-time 错误
    • Redirect(url) - 把用户重定向到另一个 URL
    • Write(data_to_write) - 向用户写文本

    Request 对象

    当浏览器从服务器请求页面时,就被称为 request。request 对象用于获取来自用户的信息。

    集合

    • ClientCertificate - 包含了在客户证书中存储的字段值
    • Cookies(name) - 包含 cookie 值
    • Form(element_name) - 包含表单值。该表单必须使用 post 方法
    • QueryString(variable_name) - 包含查询字符串中的变量值
    • ServerVariables(server_variable) - 包含服务器变量值

    属性

    • TotalBytes - 返回在请求正文中客户端所发送的字节总数

    方法

    • BinaryRead - 取回作为 post 请求的一部分而从客户端送往服务器的数据

    Server 对象

    Server 对象用于访问服务器上的属性和方法。

    属性

    ScriptTimeout - 设置或返回一段脚本在终止前所能运行多长时间。

    方法

    • CreateObject(type_of_object) - 创建对象的实例
    • Execute(path) - 从 ASP 文件内部执行另一个 ASP 文件。在被调用的 ASP 文件执行完毕后,控制权返回原先的 ASP 文件
    • GetLastError() - 返回描述所发生错误的 ASPError 对象
    • HTMLEncode(string) - 对字符串应用 HTML 编码
    • MapPath(path) - 把相对或虚拟路径映射为物理路径
    • Transfer(path) - Send all status information to another file for processing. After transmission, control of the program will not return to the original ASP file
    • URLEncode(string) - Apply URL encoding rules to strings

    Source: http://www.codew3c.com/asp/asp_quickref.asp