《ASP3高级编程》学习资料（讲稿）第二十九章附录AASP30的对象模型.pdf_大学文库

866A5p3高装编程 Chia°deo 下载表A3 Application对象的事件 OnStart 当用户在应用程序中请求一个Web页面的首个实例时触发。用于初始化变量、创建对象或运行其他代码 OnEnd 于ASP应用程序结束时,即web服务器关闭时触发。在最后一个用户的会话结束后且在此会话的 OnEnd事件中的代码已执行之后进行,应用程序中所有的变量在此事件结束后都将取消 A.2 ASPError对象 ASPError对象在ASP30中是新对象,可以通过 Server对象中的 GetLastError方法来得到。它为ASP中出现的最近一个错误提出了一系列详细信息。其属性如表A-4所示。表A4 ASPError对象的属性 ASPCode 整型,由IS产生的错误号 ASPDescription 整型,若错误与ASP相关,给出错误的详细描述 Category 字符串,表明错误的来源,如ASP本身、脚本语言或一个对象 Column 整型,在文件中产生错误的字符位置字符串,对错误的简短描述字符串,产生错误时正在运行的文件的名字整型,在文件中产生错误的行号整型,标准的COM错误码 Source 字符串,产生错误所在行的实际代码(可能得到的话) A.3 Request对象当页面请求或提交一个窗体时, Request对象包含客户端提供的所有脚本信息。这包括确定浏览者和使用者的HTTP服务器变量、存储在浏览器上对应于此域的cookie以及附加于URL 的查询字符串的值,这些值是一个查询字符串或在网页的部分的HTML控件中。还提供对证书的访问,以便用户能够使用安全套接字层(SSL)或其他的加密通信协议。其属性能帮助管理连接。其集合、属性和方法分别如表A-5、表A-6和表A-7所示。表A5 Request对象的集合 ClientCertificate 当客户访问一个页面或资源时,客户呈现给服务器的客户证书的相关条目或所有字段值的集合。每个成员都是只读的 Cookies 随着用户系统的请求一同发送来的所有 cookie值的集合,只对包括资源的域有效的 cookie才发送到服务器 Form 作为请求被提交的在段中的所有HTML控件值的集合,其 METHOD属性的值为POST。每个成员都是只读的所有在用户请求中附加于URL的名称/值的集合,或所有在中作为请求被提交的HTML控件的值,其 METHOD属性的值为GET,或是省略的。每个成员都是 ServerNariables 所有随客户的请求发送的HTTP报头值和用于Web服务器的环境变量值的集合。每个成员都是只读的

表A-3 Application对象的事件事件说明 O n S t a r t 当用户在应用程序中请求一个 We b页面的首个实例时触发。用于初始化变量、创建对象或运行其他代码 O n E n d 于A S P应用程序结束时，即We b服务器关闭时触发。在最后一个用户的会话结束后且在此会话的O n E n d事件中的代码已执行之后进行，应用程序中所有的变量在此事件结束后都将取消 A.2 ASPError对象 A S P E r r o r对象在ASP 3.0中是新对象，可以通过 S e r v e r对象中的G e t L a s t E r r o r方法来得到。它为A S P中出现的最近一个错误提出了一系列详细信息。其属性如表 A - 4所示。表A-4 ASPError对象的属性属性说明 A S P C o d e 整型，由I I S产生的错误号 A S P D e s c r i p t i o n 整型，若错误与A S P相关，给出错误的详细描述 C a t e g o r y 字符串，表明错误的来源，如 A S P本身、脚本语言或一个对象 C o l u m n 整型，在文件中产生错误的字符位置 D e s c r i p t i o n 字符串，对错误的简短描述 F i l e 字符串，产生错误时正在运行的文件的名字 L i n e 整型，在文件中产生错误的行号 N u m b e r 整型，标准的C O M错误码 S o u r c e 字符串，产生错误所在行的实际代码 (可能得到的话) A.3 Request对象当页面请求或提交一个窗体时， R e q u e s t对象包含客户端提供的所有脚本信息。这包括确定浏览者和使用者的 H T T P服务器变量、存储在浏览器上对应于此域的 c o o k i e以及附加于U R L 的查询字符串的值，这些值是一个查询字符串或在网页的部分的H T M L控件中。还提供对证书的访问，以便用户能够使用安全套接字层 ( S S L )或其他的加密通信协议。其属性能帮助管理连接。其集合、属性和方法分别如表 A - 5、表A - 6和表A - 7所示。表A-5 Request对象的集合集合说明 C l i e n t C e r t i f i c a t e 当客户访问一个页面或资源时，客户呈现给服务器的客户证书的相关条目或所有字段值的集合。每个成员都是只读的 C o o k i e s 随着用户系统的请求一同发送来的所有 c o o k i e值的集合，只对包括资源的域有效的c o o k i e才发送到服务器 F o r m 作为请求被提交的在段中的所有H T M L控件值的集合，其M E T H O D属性的值为P O S T。每个成员都是只读的 Q u e r y S t r i n g 所有在用户请求中附加于 U R L的名称／值的集合，或所有在中作为请求被提交的H T M L控件的值，其M E T H O D属性的值为 G E T，或是省略的。每个成员都是只读的 S e r v e r N a r i a b l e s 所有随客户的请求发送的 H T T P报头值和用于We b服务器的环境变量值的集合。每个成员都是只读的 866计计ASP 3 高级编程下载

是:45P30的对象模型867 载表A6 Request对象的属性 Total Bytes 整型,只读。由客户发送的请求的主题部分的总字节数表A7 Request对象的方法 Binary Read(count) 当数据作为一个POST请求的一部分被发送到服务器时,从用户请求中检索 count 字节数据,作为 Variant数组(或 Safe Array)返回。若ASP代码已引用了 Request. Forn 集合,则不能使用这种方法。同样,若使用了 Binary Read方法,也不能够成功访问 Request Form集合 A4 Response对象 Response对象用来访问将创建和发送回客户端的响应。它可使相应的HTTP变量可用,如识别服务器及其容量、将发送至浏览器的内容信息以及将存储在浏览器中对应于域的任何新的 cookie。还提供了一系列用来创建返回页面的方法。其集合、属性和方法分别如表A-8、表 A-9和表A-10所示表A-8 Response对象的集合 Cookies 包含将在当前响应中发回客户端的全部 cookie值的集合。每个成员都是只可写的表A9 Response对象的属性 Buffer=Ture False 布尔型,读/写,在处理完当前页面的服务器脚本或访问lush或End方法之前当前ASP页产生的输出将一直保存在IS缓冲区中。必须在输出发送到ⅡS之前设置,这些输出包括HTP报头信息。因此应该是asp文件中语句后的首行。在ASP30中缓冲缺省为True,其早期版本缺省设置为 False Cache Control"setting 字符串型,读/写。设置此属性为" Public",则允许代理服务器缓存页面, 或设置" Private"来防止代理缓存页面字符串型,读/写,在服务器对每个响应产生的HTTP的内容类型报头中添加字符集的名称。(如 ISO-LATIN-7) Content Type“MME-pype” 字符串型,读/写,指定作为响应的HTTP内容类型,如标准的MME类型 text/xm"或" image/gif),若省略,则将使用MME类型" ext/htm"。内容类型诉浏览器预期的内容类型。字型,读/写,按分钟来指定该页面的有效时间,若用户在该页有效期内显示其缓存的版本。超过这一时间,页面将终止,并不再保存在 private 用户)或 public(代理)中 Expires Absolute #date[ time]#日期/时间型,读/写,指定网页无效并销毁的确切日期和时间,若用户在该页有效期内返回,显示其缓存的版本。超过这一时间,页面将终止,并不再保存在 private(用户)或 public(代理)缓存中 sClient Connected 布尔型,只读。指示客户是否仍然与服务器连接并下载网页。如果客户在当前页尚未完成前转向另一页,可用 Response.End方法来结束处理

表A-6 Request对象的属性属性说明 To t a l B y t e s 整型，只读。由客户发送的请求的主题部分的总字节数表A-7 Request对象的方法方法说明 B i n a r y R e a d (c o u n t) 当数据作为一个P O S T请求的一部分被发送到服务器时，从用户请求中检索 c o u n t 字节数据，作为 Va r i a n t数组(或S a f e A r r a y )返回。若A S P代码已引用了R e q u e s t . F o r m 集合，则不能使用这种方法。同样，若使用了 B i n a r y R e a d方法，也不能够成功访问 R e q n e s t . F o r m集合 A.4 Response对象 R e s p o n s e对象用来访问将创建和发送回客户端的响应。它可使相应的 H T T P变量可用，如识别服务器及其容量、将发送至浏览器的内容信息以及将存储在浏览器中对应于域的任何新的c o o k i e。还提供了一系列用来创建返回页面的方法。其集合、属性和方法分别如表 A - 8、表 A - 9和表A - 1 0所示。表A-8 Response对象的集合集合说明 C o o k i e s 包含将在当前响应中发回客户端的全部 c o o k i e值的集合。每个成员都是只可写的表A-9 Response对象的属性属性说明 B u ff e r = Tu r e | F a l s e 布尔型，读／写，在处理完当前页面的服务器脚本或访问F l u s h或E n d方法之前，当前A S P页产生的输出将一直保存在I I S缓冲区中。必须在输出发送到I I S之前设置，这些输出包括H T T P报头信息。因此应该是. a s p文件中＜%@language = .. %＞语句后的首行。在ASP 3.0中缓冲缺省为True，其早期版本缺省设置为False CacheControl "s e t t i n g" 字符串型，读／写。设置此属性为 "Pu b l i c "，则允许代理服务器缓存页面，或设置" P r i v a t e "来防止代理缓存页面 C h a r s e t = "v a l u e" 字符串型，读／写，在服务器对每个响应产生的 HTTP 的内容类型报头中添加字符集的名称。(如I S O - L AT I N - 7 ) C o n t e n t Type “M I M E - t y p e” 字符串型，读／写，指定作为响应的 H T T P内容类型，如标准的M I M E类型 ( " t e x t / x m l "或" i m a g e / g i f " )，若省略，则将使用 M M E类型" t e x t / h t m l "。内容类型告诉浏览器预期的内容类型。 Expires m i n u t e s 数字型，读／写，按分钟来指定该页面的有效时间，若用户在该页有效期内返回，显示其缓存的版本。超过这一时间，页面将终止，并不再保存在 p r i v a t e (用户)或p u b l i c (代理)中 Expires Absolute # d a t e[ t i m e ] # 日期／时间型，读／写，指定网页无效并销毁的确切日期和时间，若用户在该页有效期内返回，显示其缓存的版本。超过这一时间，页面将终止，并不再保存在p r i v a t e（用户）或p u b l i c (代理)缓存中 I s C l i e n t C o n n e c t e d 布尔型，只读。指示客户是否仍然与服务器连接并下载网页。如果客户在当前页尚未完成前转向另一页，可用 R e s p o n s e . E n d方法来结束处理附录A ASP3.0的对象模型计计867 下载

868A5p3高装编程 Chinaopul cot 下载 (续) 属性 PICS( "PlCS-label-string 字符串型,只写,产生一个PICS报头,并且在响应中将其加入到HTTP报头中。PICS报头指明有关暴力、性和不良语言等网页内容 Status=“ code message 字符串型,读/写,指定将发送到客户端的指示页面处理是否成功的响应的 HTTP报头中的消息和状态,例如“200OK”和“404NotFound 表A-10 Response对象的方法 AddHeader(“name”,“ content”) 使用name和content值创建一个定制的HTTP报头,并将其加入到响应中。不取代已存在的同名报头,一旦添加上报头就不能删除,必须在任何网页的内容(即文本和HTML)发送到客户前使用 AppendTolog(“ string”) 当使用W3 C Extended Log file forma时,在Web日志尾部附加字符串sing。至少需要在包含此页面的站点的 Extended Properties页中选择 URL Stem Binary Write(safeArray 将 Variant类型 Safe Array的内容不进行任何字符转换写到当前的HITP输出流中。对于定制应用程序请求的二进制数据或构成图像文件的字节等非字符性信息的写入十分有用当 Response Buffer是True时,从IS响应缓冲区中删除所有缓冲页内容,不删除HTTP的响应报头,可用来终止尚未完成的网页停止ASP的脚本处理,并且返回当前生成的内容,然后终止本页的所有处理 Flush 当 Response Buffer是True时,从IS缓冲区中送出所有当前的缓冲页到客户可用来单独送出长页面的一部分 Redirect(“url”) 通过响应发出“302 Object Moved”HITP报头,指示浏览器下载在字符串 l参数中指定的网页 Write(“ sIring") 将指定的字符串string写入到HTTP响应流和IS缓冲区中,使其变成返为回页的一部分 A.5 Server对象 Server对象提供一系列对ASP脚本有用的方法和属性,最显著的是 Server CreateObject方法,它能在当前页面或会话的环境下正确地实例化其他COM对象。也存在一些方法通过将非法字符转换为其等价的合法字符,以形成RL和HIML格式。其方法和属性分别如表A-11和表A-12所示。表A-11 Server对象的属性整型。有缺省值90。设置或返回在服务器终止网页执行并报告错误前页面脚本执行的时间(秒数)。这样自动停止并从内存中删除可能锁住进程或等待资源可用的错误页面,防止服务器因错误页面超载。若网页打开需要较长时间则须增加其值表A-12 Server对象的方法 CreateObject(“ identifier”)创建一个由 identifier标识的对象(组件、应用程序或脚本对象)实例,并返回个可供代码使用的引用,可在虚拟应用程序的 global asa页中创建会话级或应用程序级范围的对象。对象可以由其自身的 ClassID(如“{ CLSID:FDC8 37A9}”)或 Pingli(如“ ADODB Connection”)来标识

(续) 属性说明 PICS( “P I C S - l a b e l - s t r i n g”) 字符串型，只写，产生一个P I C S报头，并且在响应中将其加入到 H T T P报头中。P I C S报头指明有关暴力、性和不良语言等网页内容 Status= “code message” 字符串型，读／写，指定将发送到客户端的指示页面处理是否成功的响应的 H T T P报头中的消息和状态，例如“ 200 OK”和“404 Not Found” 表A-10 Response对象的方法方法说明 A d d H e a d e r (“n a m e”,“c o n t e n t”) 使用n a m e和c o n t e n t值创建一个定制的H T T P报头，并将其加入到响应中。不取代已存在的同名报头，一旦添加上报头就不能删除，必须在任何网页的内容(即文本和H T M L )发送到客户前使用 A p p e n d To L o g (“s t r i n g”) 当使用W3C Extended Log File Format时，在We b日志尾部附加字符串s t r i n g。至少需要在包含此页面的站点的Extended Properties页中选择URL Stem B i n a r y Wr i t e (s a f e A rr a y) 将Va r i a n t类型S a f e A r r a y的内容不进行任何字符转换写到当前的 H T T P输出流中。对于定制应用程序请求的二进制数据或构成图像文件的字节等非字符性信息的写入十分有用 C l e a r ( ) 当R e s p o n s e . B u ff e r是Tr u e时，从I I S响应缓冲区中删除所有缓冲页内容，不删除H T T P的响应报头，可用来终止尚未完成的网页 E n d ( ) 停止A S P的脚本处理，并且返回当前生成的内容，然后终止本页的所有处理 F l u s h ( ) 当R e s p o n s e . B u ff e r是Tr u e时，从I I S缓冲区中送出所有当前的缓冲页到客户，可用来单独送出长页面的一部分 R e d i r e c t (“u r l”) 通过响应发出“302 Object Moved”H T T P报头，指示浏览器下载在字符串 u r l参数中指定的网页 Wr i t e (“s t r i n g”) 将指定的字符串s t r i n g写入到H T T P响应流和I I S缓冲区中，使其变成返为回页的一部分 A.5 Server对象 S e r v e r对象提供一系列对A S P脚本有用的方法和属性，最显著的是S e r v e r. C r e a t e O b j e c t方法，它能在当前页面或会话的环境下正确地实例化其他C O M对象。也存在一些方法通过将非法字符转换为其等价的合法字符，以形成U R L和H T M L格式。其方法和属性分别如表A - 11和表A - 1 2所示。表A - 11 Server对象的属性属性说明 S c r i p t Ti m e o u t 整型。有缺省值 9 0。设置或返回在服务器终止网页执行并报告错误前页面脚本执行的时间(秒数)。这样自动停止并从内存中删除可能锁住进程或等待资源可用的错误页面，防止服务器因错误页面超载。若网页打开需要较长时间则须增加其值表A-12 Server对象的方法方法说明 CreateObject (“i d e n t i f i e r”) 创建一个由i d e n t i f i e r标识的对象(组件、应用程序或脚本对象 )实例，并返回一个可供代码使用的引用，可在虚拟应用程序的 g l o b a l . a s a页中创建会话级或应用程序级范围的对象。对象可以由其自身的 C l a s s I D (如 “{ C L S I D : F D C 8 - . . . - 3 7 A 9 }”)或P i o g I D (如“A D O D B . C o n n e c t i o n”)来标识 868计计ASP 3 高级编程下载

录:A5P30的对象模型869 下载 Execute(“r”) 停止当前页执行并将控制转移到“ur”指定的页中。用户当前的环境(如会话状态和当前的事务状态)被送到新页中,新页完成以后,控制返回到原来的页面,执行 Execute方法调用后的语句 atlast Error 返回一个 ASPError对象的引用, ASPError对象包含了在ASP处理中出现的最近一个错误的详细情况,如在aspd中。 ASPerror揭示的信息包括文件名、行号和错误代码等 HTMLEncode("string") 返回 string的一个拷贝,但将所有非法的HIML字符,如“、“& 转化成等价的HTML实体,如&比、&g、&和&quot:等返回在ur中指定的文件或资源的完整物理路径和文件名停止执行当前页面,将控制转移到ul指定的页面。用户当前的环境(如会话状态和当前的事务状态)被送到新页中,与执行 Execute法不同,新页完成以后,控制不返回到原来的页面,而是直接结束 URLEncode(“ string”) 返回输入 string的拷贝,但将在URL中的所有非法字符(如’?、&’和空格)转化成等价的URL实体(%3F”、“%26和“+’) A.6 Session对象 Session对象是在每个访问者第一次从网站请求ASP页面时产生的,并且在其有效期内直保持有效(有效期由脚本决定)。提供存储变量和对象引用的场所,这些引用指向会话存活期内访问者打开的网页。其集合、属性、方法和事件分别如表A-13、表A-14、表A-15和表A-16 表A-13 Session对象的集合存储于 Session对象中的所有变量和值的一个集合,并且未用元素定义。包括 Variant数组和 Variant类型对象实例的引用 StaticObjects 用定义且存储于 Session对象中的所有变量的一个集合表A-14 Session对象的属性 Code Page 整型,读/写,定义在浏览器中显示网页内容的代码页,代码页是字符集的数字值,不同区域和不同语言可能使用不同的代码页。例如,ANS1代码页 1252用于美国英语和大多数欧洲语言,代码页932用于日语汉字整型,读/写,定义发送到浏览器的网页的地域标识符。LCID是唯一位置标识符的国际通用缩写。例如2057定义了当前位置使用的货币符号为“f”,LCID 也可用在语句中,例如在 FormatCurrency语句中,其中LCID是一个可选的变量网页的LCID也可在<%@%ASP处理指令中设置,并履盖会话的LCID属性长整型,只读,返回该会话的会话标识符,是在会话创建过程中由服务器产生的,在其父对象 Application对象存活期内是唯一的。这样在一个新的应用程序开始可以重新利用他整型,读/写,定义Seso对象的超时时间(分钟),若用户在超时时间内未刷新或请求网页,则会话结束。其值可以根据需要在单独的页面中修改,缺省的时间是20分钟,在高访问率的网站中可能要设置更短的时间

(续) 方法说明 E x e c u t e (“u r l”) 停止当前页执行并将控制转移到“ u r l”指定的页中。用户当前的环境 (如会话状态和当前的事务状态 )被送到新页中，新页完成以后，控制返回到原来的页面，执行E x e c u t e方法调用后的语句 G e t L a s t E r r o r ( ) 返回一个A S P E r r o r对象的引用，A S P E r r o r对象包含了在A S P处理中出现的最近一个错误的详细情况，如在 a s p . d l l中。A S P E r r o r揭示的信息包括文件名、行号和错误代码等 H T M L E n c o d e (“s t r i n g”) 返回s t r i n g的一个拷贝，但将所有非法的 H T M L字符，如‘’、‘&’ 转化成等价的H T M L实体，如& l t ;、& g t ;、& a m p ;和& q u o t ;等 M a pPa t h (“u r l”) 返回在u r l中指定的文件或资源的完整物理路径和文件名 Tr a n s f e r (“u r l”) 停止执行当前页面，将控制转移到 u r l指定的页面。用户当前的环境 (如会话状态和当前的事务状态 )被送到新页中，与执行 E x e c u t e方法不同，新页完成以后，控制不返回到原来的页面，而是直接结束 U R L E n c o d e (“s t r i n g”) 返回输入s t r i n g的拷贝，但将在U R L中的所有非法字符(如’?’、’&’和空格)转化成等价的U R L实体(‘% 3 F’、‘% 2 6’和‘+’) A.6 Session对象 S e s s i o n对象是在每个访问者第一次从网站请求 A S P页面时产生的，并且在其有效期内一直保持有效(有效期由脚本决定)。提供存储变量和对象引用的场所，这些引用指向会话存活期内访问者打开的网页。其集合、属性、方法和事件分别如表 A - 1 3、表A - 1 4、表A - 1 5和表A - 1 6 所示。表A-13 Session对象的集合集合说明 C o n t e n t s 存储于S e s s i o n对象中的所有变量和值的一个集合，并且未用元素定义。包括Va r i a n t数组和Va r i a n t类型对象实例的引用 S t a t i c O b j e c t s 用定义且存储于S e s s i o n对象中的所有变量的一个集合表A-14 Session对象的属性属性说明 C o d e P a g e 整型，读／写，定义在浏览器中显示网页内容的代码页，代码页是字符集的数字值，不同区域和不同语言可能使用不同的代码页。例如， A N S I代码页 1 2 5 2用于美国英语和大多数欧洲语言，代码页 9 3 2用于日语汉字 L C I D 整型，读／写，定义发送到浏览器的网页的地域标识符。LCID是唯一位置标识符的国际通用缩写。例如2 0 5 7定义了当前位置使用的货币符号为“￡”，L C I D 也可用在语句中，例如在F o r m a t C u r r e n c y语句中，其中L C I D是一个可选的变量，网页的LCID也可在ASP处理指令中设置，并履盖会话的LCID属性 S e s s i o n I D 长整型，只读，返回该会话的会话标识符，是在会话创建过程中由服务器产生的，在其父对象 A p p l i c a t i o n对象存活期内是唯一的。这样在一个新的应用程序开始可以重新利用他 Ti m e o u t 整型，读／写，定义S e s s i o n对象的超时时间(分钟)，若用户在超时时间内未刷新或请求网页，则会话结束。其值可以根据需要在单独的页面中修改，缺省的时间是2 0分钟，在高访问率的网站中可能要设置更短的时间附录A ASP3.0的对象模型计计869 下载

《ASP3高级编程》学习资料（讲稿）第二十九章 附录AASP30的对象模型

《ASP3高级编程》学习资料（讲稿）第二十九章附录AASP30的对象模型