全面解析Server对象
- 格式：doc
- 大小：71.50 KB
- 文档页数：12
ZYDSoft NetBox 2.7
Server 对象
Server对象提供对服务器上的方法和属性的访问，其中大多数方法和属性是作为实用程序的功能服务的
语法
Server.property|method
属性
ScriptTimeout ScriptTimeout 属性指定脚本在结束前最大可运行多长时间，目前版本的NetBox不支持超时方法
CreateObject CreateObject方法创建服务器组件的实例
Execute Execute方法执行一个 .asp 文件然后返回调用者
GetLastE rror GetLastError 方法返回一个ScriptE rror对象用于描述当前asp 程序的运行错误
HTMLE ncode HTMLE ncode 方法对指定的字符串应用HTML 编码
MapPath MapPath方法将指定的相对或虚拟路径映射到服务器上相应的物理目录上
T ransfer T ransfer方法执行一个 .asp 文件然后结束处理
UrlE ncode UrlE ncode方法将URL 编码规则，包括转义字符，应用到指定的字符串
CreateObject 方法
CreateObject方法创建服务器组件的实例语法
Server.CreateObject(progID)
参数
progID
指定要创建的对象的类型
注释
可以使用Server.CreateObject创建一个新的对象实例，Server.CreateObject可以创建的对象分为三种，第一种是已经在系统注册过的标准 COM 对象，作用等同于 VBScript 本身的CreateObject，比如：
Set rs = Server.CreateObject("ADODB.RecordSet")
第二种是NetBox内部提供给 Script 使用的标准对象，具体的对象 ProgID 及其使用方法可以参考手册，比如：
Set socket = Server.CreateObject("NetBox.Socket")
第三种是以 wsc 格式书写并在NetBox内部注册成功的脚本部件，比如：
NetBox.RegisterClass "\wsc\MyClass.wsc"
Set o = Server.CreateObject("myclass")
其中 "\wsc\MyClass.wsc" 是以 wsc 格式书写的脚本部件，其 ProgID 为 ''myclass"。
以上三类对象的查找顺序为：
1.wsc 对象
Box标准内部对象
3.系统注册的标准 COM 对象
默认情况下，由Server.CreateObject方法创建的对象具有页作用域。
这就是说，再当前 ASP 页处理完成之后，服务器将自动破坏这些对象。
应用于
Server 对象
ScriptTimeout 属性
ScriptTimeout 属性指定脚本在结束前最大可运行多长时间，目前版本的NetBox不支持超时
语法
Server.ScriptTimeout =NumSeconds
参数
NumSeconds
指定脚本在被服务器结束前最大可运行的秒数
示例
以下示例中，如果服务器处理脚本超过 100 秒，将使之超时。
<% Server.ScriptTimeout = 100 %>
以下示例获取ScriptTimeout 属性当前值，并将其存储在变量 TimeOut 中。
<% TimeOut = Server.ScriptTimeout %>
应用于
Server 对象
Execute 方法
Execute方法执行一个 .asp 文件然后返回调用者
语法
Server.Execute(Path)
参数
Path
给定的 .asp 文件名
应用于
Server 对象
GetLastError 方法
GetLastError 方法返回一个ScriptError对象用于描述当前 asp 程序的运行错误
语法
Server.GetLastError()
注释
使用Script.GetLastError 可以取得Script 对象最后的错误信息，包括语法错误、运行错误等。
返回信息存放在一个ScriptE rror对象中。
HTMLEncode 方法
HTMLEncode 方法对指定的字符串应用 HTML 编码
语法
Server.HTMLEncode(string )
参数
string
指定要编码的字符串
示例
下面的脚本程序
<%= Server.HTMLEncode("The paragraph tag: <P>")%>
将输出下面的文字
The paragraph tag: <P>
经过浏览器自动解码，将现实下面的现实内容
The paragraph tag: <P>
如果你使用 View Source 察看页面的代码，将看到经过编码的文本。
MapPath 方法
MapPath方法将指定的相对或虚拟路径映射到服务器上相应的物理目录上
语法
Server.MapPath(Path)
参数
Path
指定要映射物理目录的相对或虚拟路径。
若Path 以一个正斜杠(/) 或反斜杠(\) 开始，则MapPath 方法返回路径时将Path 视为完整的虚拟路径。
若Path 不是以斜杠开始，则MapPath 方法返回同 .asp 文件中已有的路径相对的路径。
注释
MapPath 方法不支持相对路径语法 (.) 或 (..)。
例如，下列相对路径 ../MyDir/MyFile.txt 返回一个错误。
MapPath 方法不检查返回的路径是否正确或在服务器上是否存在。
因为MapPath 方法只映射路径而不管指定的目录是否存在，所以，您可以先用MapPath 方法映射物理目录结构的路径，然后将其传递给在服务器上创建指定目录或文件的组件。
示例
对于下列示例，文件 data.txt 和包含下列脚本的 test.asp 文件都位于目录 C:\NetBox\Wwwroot\Script 下。
C:\NetBox\Wwwroot 目录被设置为服务器的宿主目录。
下列示例使用服务器变量 PATH_INFO 映射当前文件的物理路径。
脚本
<%= server.mappath(Request.ServerVariables("PATH_INFO"))%><BR>
输出
c:\NetBox\wwwroot\script\test.asp<BR>
由于下列示例中的路径参数不是以斜杠字符开始的，所以它们被相对映射到当前目录，此处是 C:\NetBox\Wwwroot\Script。
脚本
<%= server.mappath("data.txt")%><BR>
<%= server.mappath("script/data.txt")%><BR>
输出
c:\NetBox\wwwroot\script\data.txt<BR>
c:\NetBox\wwwroot\script\script\data.txt<BR>
接下来的两个示例使用斜杠字符指定返回的路径应被视为在服务器的完整虚拟路径。
脚本<%= server.mappath("/script/data.txt")%><BR>
<%= server.mappath("\script")%><BR>
输出
c:\NetBox\wwwroot\script\data.txt<BR>
c:\NetBox\wwwroot\script<BR>
下列示例演示如何使用正斜杠 (/) 或反斜杠 (\) 返回宿主目录的物理路径。
脚本
<%= server.mappath("/")%><BR>
<%= server.mappath("\")%><BR>
输出
c:\NetBox\wwwroot<BR>
c:\NetBox\wwwroot<BR>
Transfer 方法
Transfer方法执行一个 .asp 文件然后结束处理
语法
Server.Transfer(Path)
参数
Path
给定的 .asp 文件名
UrlEncode 方法
UrlEncode方法将 URL 编码规则，包括转义字符，应用到指定的字符串
语法
Server.UrlEncode(string )
参数
String
指定要编码的字符串
示例
下面的脚本代码：
<%=Server.UrlEncode("[test]")%> 运行结果为：
%5Btest%5D。
