(1) 遍历Contents集合的代码

(1)  遍历Contents集合的代码
为了遍历Contents集合，可使用一个For Each ... Next结构。集合中的每一项可以是一个简单的Variant类型变量、一个Variant数组或者一个对象的引用。因为需要对每种类型的值进行不同的处理，所以就不得不对每一个进行检查来判别其类型。
在VBScript中可使用VarType函数完成这个工作。这里使用IsObject和IsArray函数代替：
For Each objItem in Application.Contents
    If IsObject(Application.Contents(objItem)) Then
        Response.Write “Object reference: ‘” & objItem & “’<BR>”
    ElseIf IsArray(Application.Contents(objItem)) Then
        Response.Write “Array: ‘” & objItem & “’ contents are:<BR>”
        VarArray = Application.Contents(objItem)
        ‘Note: the following only works with a one-dimensional array
        For intLoop = 0 To UBound(varArray)
            Response.Write “&nbsp; Index(“ & intLoop & “) = “ & _
                        VarArray(intLoop) & “<BR>”
        Next
    Else
        Response.Write “Variable: ‘” & objItem & “’ = “ _
                    & Application.Contents(objItem) & “<BR>”
    End If
Next
注意程序如何从Application对象检索该数组。将其分配给一个局部（Variant）变量，使用下面的语句：
varArray = Application.Contents(objItem)
使用UBound函数可以查找出数组的大小（元素的数量），这个值可以作为遍历的终止条件：
For intLoop = 0 UBound(varArray)
这个例子是一维数组，并将只显示这样的一个数组的内容。可根据需要编辑代码以处理多维数组，例如：
For intLoop = 0 To UBound(varArray)
    IntNumberOfDimensions = UBound(varArray, 1)
    For intDimension = 0 To intNumberOfDimensions
        Response.Write “&nbsp; Index(“ & intLoop & “) = “ _
                & varArray(intLoop, intDimension)
    Next
    Response.Write “<BR>”
Next
(2)  遍历StaticObjects集合的代码
StaticObjects集合包含了所有在global.asa中使用<OBJECT>元素声明的对象引用。因为每个条目都是一个对象变量，可用
简单些的代码对这个数组进行遍历。我们将输出对象的名字（在ID属性中原有的定义）：
For Each objItem in Application.StaticObjects
    If IsObject(Application.StaticObjects(objItem)) Then
        Response.Write “<OBJECT> element: ID=’” & objItem & “’<BR>”
    End If
Next
1．  增加值到Contents集合
增加值到Contents集合的方法，与在global.asa网页的脚本代码中使用过的方法相同。示例网页允许把一个新的Variant值
增加到Application对象中，并已有建议的名字和值（可根据需要进行编辑），如图3-15所示：

图3-15  增加值到Contents集合的屏幕
单击按钮，重新载入这个网页，把值增加到Application.Contents集合中，并且在列表中显示，如图3-16所示：

图3-16  显示Contents集合内容的屏幕
       增加新的Contents条目的代码
       所有的按钮和其他HTML控件放置在示例网页中的一个窗体上。ACTION设置了当前网页的路径，提交该窗体时，重新
装入。METHOD属性为“POST”，所以控件中的值出现在Request.Form集合中。在以前的章节中采用过这两种技术：
       <FORM ACTION=”<% = Request.ServerVariables(“SCRIPT_NAME”) %>” METHOD=”POST”>
       该窗体上的按钮都是普通的HTML INPUT控件，具有相同的标题（三个空格）但名字不同。例如，创建第一个按钮（把值增加到Application对象中）的代码是：
       <INPUT TYPE=”SUBMIT” NAME=”cmdAdd” VALUE=”&nbsp;&nbsp;&nbsp;”>
       重新载入该网页时，检查Request.Form集合，判定单击的是哪个SUBMIT按钮，并进行相应的处理。如果是增加一个值到Application对象的按钮（该按钮在HTML的<INPUT>元素中被命名为cmdAdd），使用下面的程序段：
If Len(Request.Form("cmdAdd")) Then
   strVarName = Request.Form("txtVarName")
   strVarValue = Request.Form("txtVarValue")
   Application.Lock
   Application("strVarName") = strVarValue
   Application.Unlock
End If
       注意程序如何使用Application.Lock和Application.Unlock方法，确保这些值不会因两个用户并发地访问而产生混
乱。如果只是对一个特定的值进行设置，一般不可能发生这种情况。但一直使用Lock和Unlock方法是明智的。
2．  Contents集合中删除值
在例子网页的底部有两个按钮，如图3-17所示：

图3-17  显示在网页底部的两个按钮
这两个按钮允许从Application.Contents集合中删除值。第一个按钮从集合中删除单个的指定值，下拉列表框显示的是
Contents集合值的名字的列表（记住，不能从StaticObjects集合中删除值，因为它们是静态的）。
通过遍历Contents集合（如前面我们所做的）执行ASP网页时，创建该列表。但是，我们仅收集每项的名字并把它们放到
<SELECT>列表元素内的<OPTION>元素中：
…
<SELECT NAME=”lstRemove” SIZE=”1”>
<%
For Each objItem in Application.Contents
       Response.Write “<OPTION>” & objItem & “</OPTION>”
Next
&>
</SELECT>
…
该ASP代码执行以后，在浏览器中看到的结果是：
<SELECT NAME=”lstRemove” SIZE=”1”>
       <OPTION>ADOConnection</OPTION>
       <OPTION>Variant_Array</OPTION>
       <OPTION>Start_Time</OPTION>
       <OPTION>Visit_Count</OPTION>
       <OPTION>My_New_Value</OPTION>
</SELECT>
(1)    删除单个值
当单击按钮删除单个值时，该窗体再次提交给相同的网页，但是这一次将查找名为cmdRemoveThis的SUBMIT按钮。如果存在（即单击了这个按钮），则使用列表框的值，调用Application.Contents集合的Remove方法：
If Len(Request.Form("cmdRemoveThis")) Then
   strToRemove = Request.Form("lstRemove")
   Response.Write "strToRemove = " & strToRemove
   Application.Lock
   Application.Contents.Remove(strToRemove)
   Application.Unlock
End If
注意这是Contents集合的一个方法，而不是Application对象的。语法是Application.Contents.Remove，而不是
Application.Remove。
从Contents集合中删除Start_Time值的结果如图3-18所示：

图3-18  删除Start_Time值后的屏幕
(2)    删除所有的值
如果单击三个SUBMIT类型按钮中的最后一个（如图3-18所示），该网页中的代码将检测到单击的按钮为cmdRemoveAll，将
执行Application.Contents集合的RemoveAll方法：
If Len(Request.Form("cmdRemoveAll")) Then
   Application.Lock
   Application.Contents.RemoveAll
   Application.Unlock
End If
再次提醒，这是Contents集合的一个方法，而不是Application。语法是Application.Contents.RemoveAll，而不是
Application.RemoveAll。
图3-19所示的是从Contents集合中删除所有值的结果（记住在运行时间不能从StaticObjects集合删除项）：

图3-19  删除Contents集合中所有值的屏幕

3.3.5 活动中的ASP Session对象
       示例网页的第二个示例页面show_session.asp，示范了如何使用Session对象。可在Chapter03子目录中的开始菜单（Default.asp）中打开它。
1．  显示和更新Session集合
Session对象示例页面看起来与刚刚使用过的Application对象示例页面相似。它遍历Session对象的Contents和StaticObjects集合，显示其名字和（可能的话）相应的值。如果把这些值与Application对象页面进行比较，将会看到不同之处。
这里还能够看到客户端IP地址的一些其他值。这是当会话启动时global.asa中的代码从Request.ServerVariables集合中得到的。这个页面还显示四个会话属性的值，如图3-20所示：

图3-20  Session对象显示属性的屏幕
下面是例子中使用的golbal.asa文件的相关段落，它把缺省值增加到图3-20所示的屏幕上所看到的会话中：
...
<!-- Declare instance of the ASPContentLink component
     with session-level scope //-->
<OBJECT ID="ASPContentLink" RUNAT="Server" SCOPE="Session"
        PROGID="MSWC.NextLink">
</OBJECT>

<SCRIPT LANGUAGE="VBScript" RUNAT="Server">
...
...
Sub Session_onStart()

'Create an instance of the AdRotator component with session-level scope
  Set Session("ASPAdRotator") = Server.CreateObject("MSWC.AdRotator")
  Dim varArray(3)                          'Create a Variant array and fill it
  varArray(0) = "This is a"
  varArray(1) = "Variant array"
  varArray(2) = "stored in the"
  varArray(3) = "Session object"
  Session("Variant_Array") = varArray      'Store it in the Session
  Session("Start_Time") = CStr(Now)        'Store the date/time as a string

'We can access the contents of the Request and Response in a Session_onStart
'event handler for the page that initiated the session. This is the *only*
'place that the ASP page context is available like this.
'as an example, we can get the IP address of the user:
  Session("Your_IP_Address") = Request.ServerVariables("REMOTE_ADDR")

  Application.Lock                              'Prevent concurrent updates  
  intVisits = Application("Visit_Count") + 1    'Increment counter variable
  Application("Visit_Count") = intVisits        'Store back in Application
  Application.Unlock                            'Release lock on Application

End Sub
...
...
</SCRIPT>
遍历Contents和StaticObjects集合的代码与前面在Application对象示例中使用的代码一样，只不过这里引用了Session.Contents和Session.StaticObjects集合，而不是Application.Contents和Appliction.StaticObjects集合。
靠近页面底部的按钮的功能是把值增加到Session.Contents集合和从Session.Contents集合删除值。这些按钮与在Application对象示例页面中相应的按钮工作方式相同，这里访问的是Session.Contents集合，以及相应的Remove和
RemoveAll方法。我们不再重复解释。
2．  终止一个用户会话
在Session对象页面的底部有一个按钮，该按钮终止当前的用户会话，这通过调用Session对象的Abandon方法实现。它与其余的HTML控件在相同的窗体上，名为cmdAbandon。当该窗体再次被提交给这个网页时，在Request.Form集合中查找这个值（如同在Application对象例子中做的一样）。如发现这个值，则将该用户重定向到另一个网页：
If Len(Request.Form("cmdAbandon")) Then
   Response.Clear
   Response.Redirect "abandon.asp"
   Response.End
End If
新的页面名为abandon.asp，十分简单，除了创建消息的文本和HTML以外只有如下的代码：
<% Session.Abandon %>
该网页的其余部分只是一个包含单个SUBMIT按钮的窗体。注意如何使用来自Request.ServerVariables集合的引用网页
（HTTP_REFERER）的URL的值，以确保重新载入前一个网页（Session对象例子网页）：
<FORM ACTION="<% = Request.ServerVariables("HTTP_REFERER") %>" METHOD="POST">
<P><DIV CLASS="subhead">Your Session Has Been Terminated</DIV>
A new <B>Session</B> will be started when you load another<BR>
ASP page. It will contain any values that are defined in<BR>
the <B>global.asa</B> file for this application.<P>
<INPUT TYPE="SUBMIT" NAME="cmdOK" VALUE="&nbsp;&nbsp;&nbsp;">
&nbsp; Return to the previous page<P>
</FORM>
结果如图3-21所示。这时，当前的用户会话已经被终止（放弃），并且该用户不能引用原先的Session集合或属性的内容：

图3-21  终止一个用户会话后的屏幕
然而，记住这一切是在调用Abandon方法的网页执行时，甚至在对该方法的调用已经完成以后，仍能够从Session对象中获得用户的会话内容。当此网页结束时，会话才结束。当然，当返回到显示会话内容的Session对象示例网页时，将启动一个新的ASP会话。它将有一个不同的Start_Time值和通过执行global.asa中的代码创建的其他缺省的会话值，如图3-22所示：

图3-22  重新建立一个用户会话后的屏幕
注意，Session.SessionID属性值没有改变。ASP试图重新分配相同的会话ID，因此不能依靠该值来判定一个新的会话已经启动。

3.4 小结
    本章介绍了两个ASP内置对象：Application和Session对象。这些对象引入了ASP的应用程序和用户会话的概念（两者都是特定的术语，并且不是通常谈话时的意义）。ASP应用程序允许分配专门的属性给页面集，定义了IIS和ASP如何管理这
些网页及所使用的其他组件。
    然而，使用ASP应用程序和会话的主要原因是需要自动地获得状态。换句话说，存储信息和变量引用的能力，要么对用户装载的所有网页是全局和可用的（即在一个应用程序中），要么仅仅对一个指定的用户的所有网页是可用的（在一个会话中）。这使建立Web应用程序变得非常简单（即应用程序在Web上工作，但能够像传统的编译的应用程序一样能完成指定的任务）。
    本章通过一些示例页面，详细介绍如何使用ASP的Application和Session对象。这些页面示范了这两个对象可用的所有技术。