server|對象
Server 對象提供對伺服器上的方法和屬性的訪問。其中大多數方法和屬性是作為公用程式的功能服務的。
文法
Server.property|method
ScriptTimeout
ScriptTimeout 屬性指定指令碼在結束前最大可運行多長時間。
當處理伺服器組件時,逾時限制將不再生效。
文法
Server.ScriptTimeout = NumSeconds
參數
NumSeconds
指定指令碼在被伺服器結束前最大可啟動並執行秒數。預設值為 90 秒。
注釋
通過使用中繼資料庫中的 AspScriptTimeout 屬性可以為 Web 服務或 Web 服務器設定預設的 ScriptTimeout 值。ScriptTimeout 屬性不能設定為小於在中繼資料庫中指定的值。例如,如果 NumSeconds 設定為 10,而中繼資料庫設定包含了預設值 90 秒,則指令碼在 90 秒後逾時。但如果 NumSeconds 設定為 100,則指令碼在 100 秒後逾時。
關於使用中繼資料庫的詳細資料,參閱 關於中繼資料庫。
樣本
以下樣本中,如果伺服器處理指令碼超過 100 秒,將使之逾時。
<% Server.ScriptTimeout = 100 %>
以下樣本擷取 ScriptTimeout 屬性當前值,並將其儲存在變數 TimeOut 中。
<% TimeOut = Server.ScriptTimeout %>
CreateObject
CreateObject 方法建立伺服器組件的執行個體。如果該組件執行了 OnStartPage 和 OnEndPage 方法,則此時就會調用 OnStartPage 方法。
文法
Server.CreateObject( progID )
參數
progID
指定要建立的對象的類型。progID 的格式為 [Vendor.] component[.Version]。
注釋
預設情況下,由 Server.CreateObject 方法建立的對象具有頁範圍。這就是說,再當前 ASP 頁處理完成之後,伺服器將自動破壞這些對象。
要建立有會話或Application 領域的對象,可以使用 <OBJECT> 標記並設定 SESSION 或 APPLICATION 的 SCOPE 屬性,也可以在對話及應用程式變數中儲存該對象。
例如,在如下所示的指令碼中,當 Session 對象被破壞,即當對話逾時時或 Abandon 方法被調用時,儲存在會話變數中的對象也將被破壞。
<% Set Session("ad") = Server.CreateObject("MSWC.AdRotator")%>
可以通過將變數設定為 Nothing 或新的值來破壞對象,如下所示。第一個例子釋放 ad 對象,第二個例子用字串代替 ad 。
<% Session ("ad") = Nothing %>
<% Session ("ad") = " Other Valum " %>
不能建立與內建對象同名的對象執行個體。 例如,下列指令碼將返回錯誤。
<% Set Response = Server.CreateObject("Response") %>
樣本
<% Set MyAd = Server.CreateObject("MSWC.AdRotator") %>
上面的例子建立一個名為 MyAd 的 MSWC.AdRotator 伺服器組件,MSWC.AdRotator 組件可用於在 Web 頁上的自動輪換廣告。
HTMLEncode
HTMLEncode 方法對指定的字串應用 HTML 編碼。
文法
Server.HTMLEncode( string )
參數
string
指定要編碼的字串。
樣本
指令碼
<%= Server.HTMLEncode("The paragraph tag: <P>") %>
輸出
The paragraph tag: <P>
注意 以上輸出將被 網頁瀏覽器顯示為
The paragraph tag: <P>
如果查看一下源檔案或以文本方式開啟一個 Web 頁,您就可以看到已編碼的 HTML。
MapPath
MapPath 方法將指定的相對或虛擬路徑映射到伺服器上相應的物理目錄上。
文法
Server.MapPath( Path )
參數
Path
指定要映射物理目錄的相對或虛擬路徑。若 Path 以一個正斜杠 (/) 或反斜線 (\) 開始,則 MapPath 方法返迴路徑時將 Path 視為完整的虛擬路徑。若 Path 不是以斜杠開始,則 MapPath 方法返回同 .asp 檔案中已有的路徑相對的路徑。
注釋
MapPath 方法不支援相對路徑文法 (.) 或 (..)。例如,下列相對路徑 ../MyDir/MyFile.txt 返回一個錯誤。
MapPath 方法不檢查返回的路徑是否正確或在伺服器上是否存在。
因為 MapPath 方法只映射路徑而不管指定的目錄是否存在,所以,您可以先用 MapPath 方法映射物理目錄結構的路徑,然後將其傳遞給在伺服器上建立指定目錄或檔案的組件。
樣本
對於下列樣本,檔案 data.txt 和包含下列指令碼的 test.asp 檔案都位於目錄 C:\Inetpub\Wwwroot\Script 下。C:\Inetpub\Wwwroot 目錄被設定為伺服器的宿主目錄。
下列樣本使用伺服器變數 PATH_INFO 映射當前檔案的實體路徑。指令碼
<%= server.mappath(Request.ServerVariables("PATH_INFO"))%>
輸出
c:\inetpub\wwwroot\script\test.asp
由於下列樣本中的路徑參數不是以斜杠字元開始的,所以它們被相對映射到目前的目錄,此處是 C:\Inetpub\Wwwroot\Script。指令碼
<%= server.mappath("data.txt")%>
<%= server.mappath("script/data.txt")%>
輸出
c:\inetpub\wwwroot\script\data.txt
c:\inetpub\wwwroot\script\script\data.txt //aspxuexi.com
接下來的兩個樣本使用斜杠字元指定返回的路徑應被視為在伺服器的完整虛擬路徑。指令碼
<%= server.mappath("/script/data.txt")%>
<%= server.mappath("\script")%>
輸出
c:\inetpub\script\data.txt
c:\inetpub\script
下列樣本示範如何使用正斜杠 (/) 或反斜線 (\) 返回宿主目錄的實體路徑。指令碼
<%= server.mappath("/")%>
<%= server.mappath("\")%>
輸出
c:\inetpub\wwwroot
c:\inetpub\wwwroot
URLEncode
URLEncode 方法將 URL 編碼規則,包括逸出字元,應用到指定的字串。
文法
Server.URLEncode( string )
參數
String
指定要編碼的字串。
樣本
指令碼
<%Response.Write(Server.URLEncode("http://www.microsoft.com")) %>
輸出
http%3A%2F%2Fwww%2Emicrosoft%2Ecom