Server 对象提供对服务器上的方法和属性的访问其中大多数方法和属性是作为实用程序的功能服务的
语法
Serverproperty|method
ScriptTimeout
ScriptTimeout 属性指定脚本在结束前最大可运行多长时间
当处理服务器组件时超时限制将不再生效
语法
ServerScriptTimeout = NumSeconds
参数
NumSeconds
指定脚本在被服务器结束前最大可运行的秒数默认值为 秒
注释
通过使用元数据库中的 AspScriptTimeout 属性可以为 Web 服务或 Web 服务器设置缺省的 ScriptTimeout 值ScriptTimeout 属性不能设置为小于在元数据库中指定的值例如如果 NumSeconds 设置为 而元数据库设置包含了默认值 秒则脚本在 秒后超时但如果 NumSeconds 设置为 则脚本在 秒后超时
关于使用元数据库的详细信息参阅 关于元数据库
示例
以下示例中如果服务器处理脚本超过 秒将使之超时
<% ServerScriptTimeout = %>
以下示例获取 ScriptTimeout 属性当前值并将其存储在变量 TimeOut 中
<% TimeOut = ServerScriptTimeout %>
CreateObject
CreateObject 方法创建服务器组件的实例如果该组件执行了 OnStartPage 和 OnEndPage 方法则此时就会调用 OnStartPage 方法
语法
ServerCreateObject( progID )
参数
progID
指定要创建的对象的类型progID 的格式为 [Vendor] component[Version]
注释
默认情况下由 ServerCreateObject 方法创建的对象具有页作用域这就是说再当前 ASP 页处理完成之后服务器将自动破坏这些对象
要创建有会话或应用程序作用域的对象可以使用 <OBJECT> 标记并设置 SESSION 或 APPLICATION 的 SCOPE 属性也可以在对话及应用程序变量中存储该对象
例如在如下所示的脚本中当 Session 对象被破坏即当对话超时时或 Abandon 方法被调用时存储在会话变量中的对象也将被破坏
<% Set Session(ad) = ServerCreateObject(MSWCAdRotator)%>
可以通过将变量设置为 Nothing 或新的值来破坏对象如下所示第一个例子释放 ad 对象第二个例子用字串代替 ad
<% Session (ad) = Nothing %>
<% Session (ad) = Other Valum %>
不能创建与内建对象同名的对象实例 例如下列脚本将返回错误
<% Set Response = ServerCreateObject(Response) %>
示例
<% Set MyAd = ServerCreateObject(MSWCAdRotator) %>
上面的例子创建一个名为 MyAd 的 MSWCAdRotator 服务器组件MSWCAdRotator 组件可用于在 Web 页上的自动轮换广告
HTMLEncode HTMLEncode 方法对指定的字符串应用 HTML 编码
语法
ServerHTMLEncode( string )
参数
string
指定要编码的字符串
示例
脚本
<%= ServerHTMLEncode(The paragraph tag: <P>) %>
输出
The paragraph tag: <P>
注意 以上输出将被 Web 浏览器显示为
The paragraph tag: <P>
如果查看一下源文件或以文本方式打开一个 Web 页您就可以看到已编码的 HTML
MapPath
MapPath 方法将指定的相对或虚拟路径映射到服务器上相应的物理目录上
语法
ServerMapPath( Path )
参数
Path
指定要映射物理目录的相对或虚拟路径若 Path 以一个正斜槓 (/) 或反斜槓 (\) 开始则 MapPath 方法返回路径时将 Path 视为完整的虚拟路径若 Path 不是以斜槓开始则 MapPath 方法返回同 asp 文件中已有的路径相对的路径
注释
MapPath 方法不支持相对路径语法 () 或 ()例如下列相对路径 /MyDir/MyFiletxt 返回一个错误
MapPath 方法不检查返回的路径是否正确或在服务器上是否存在
因为 MapPath 方法只映射路径而不管指定的目录是否存在所以您可以先用 MapPath 方法映射物理目录结构的路径然后将其传递给在服务器上创建指定目录或文件的组件
示例
对于下列示例文件 datatxt 和包含下列脚本的 testasp 文件都位于目录 C:\Inetpub\Wwwroot\Script 下C:\Inetpub\Wwwroot 目录被设置为服务器的宿主目录
下列示例使用服务器变量 PATH_INFO 映射当前文件的物理路径脚本
<%= servermappath(RequestServerVariables(PATH_INFO))%>
输出
c:\inetpub\wwwroot\script\testasp
由于下列示例中的路径参数不是以斜槓字符开始的所以它们被相对映射到当前目录此处是 C:\Inetpub\Wwwroot\Script脚本
<%= servermappath(datatxt)%>
<%= servermappath(script/datatxt)%>
输出
c:\inetpub\wwwroot\script\datatxt
c:\inetpub\wwwroot\script\script\datatxt //
接下来的两个示例使用斜槓字符指定返回的路径应被视为在服务器的完整虚拟路径脚本
<%= servermappath(/script/datatxt)%>
<%= servermappath(\script)%>
输出
c:\inetpub\script\datatxt
c:\inetpub\script
下列示例演示如何使用正斜槓 (/) 或反斜槓 (\) 返回宿主目录的物理路径脚本
<%= servermappath(/)%>
<%= servermappath(\)%>
输出
c:\inetpub\wwwroot
c:\inetpub\wwwroot
URLEncode
URLEncode 方法将 URL 编码规则包括转义字符应用到指定的字符串
语法
ServerURLEncode( string )
参数
String
指定要编码的字符串
示例
脚本
<%ResponseWrite(ServerURLEncode()) %>
输出
http%A%F%Fwww%Emicrosoft%Ecom
