Managing Application State

This sample illustrates the use of application state to read a dataset in Application_Start.
这个例子说明了在Application_Start中用application state读取数据。

VB Application2.aspx [Run Sample] | [View Source]

Because an application and all the objects it stores can be concurrently accessed by different threads, it is better to store only infrequently modified data with application scope. Ideally an object is initialized in the Application_Start event and further access is read-only.
因为程序和它的所有对象能被不同的线程并发的访问，最好用application scope保存唯一的很少被修改的数据。理想状态下是在Application_Start事件中对象已经被初始化并且设为只读访问。

In the following sample a file is read in Application_Start (defined in the Global.asax file) and the content is stored in a DataView object in the application state.
下面的例子是在Application_Start事件里读取一个文件（在Global.asax里定义）并且把DataView对象的内容存储在application state。

void Application_Start() {
    DataSet ds = new DataSet();

    FileStream fs = new FileStream(Server.MapPath("schemadata.xml"),FileMode.Open,FileAccess.Read);
    StreamReader reader = new StreamReader(fs);
    ds.ReadXml(reader);
    fs.Close();

    DataView view = new DataView(ds.Tables[0]);
    Application["Source"] = view;
}

Sub Application_Start()
    Dim ds As New DataSet()

    Dim fs As New FileStream(Server.MapPath("schemadata.xml"),FileMode.Open,FileAccess.Read)
    Dim reader As New StreamReader(fs)
    ds.ReadXml(reader)
    fs.Close()

    Dim view As New DataView (ds.Tables(0))
    Application("Source") = view
End Sub

function Application_Start() : void {
    var ds:DataSet = new DataSet();

    var fs:FileStream = new FileStream(Server.MapPath("schemadata.xml"),FileMode.Open,FileAccess.Read);
    var reader:StreamReader = new StreamReader(fs);
    ds.ReadXml(reader);
    fs.Close();

    var view:DataView = new DataView(ds.Tables[0]);
    Application("Source") = view;
}

In the Page_Load method, the DataView is then retrieved and used to populate a DataGrid object:
在Page_Load方法，DataView被使用并用于绑定DataGrid对象。

void Page_Load(Object sender, EventArgs e) {
    DataView Source = (DataView)(Application["Source"]);
    ...
    MyDataGrid.DataSource = Source;
    ...
}

Sub Page_Load(sender As Object, e As EventArgs)
    Dim Source As New DataView  = CType(Application("Source"), DataView)
    ...
    MyDataGrid.DataSource = Source
    ...
End Sub

function Page_Load(sender:Object, e:EventArgs) : void {
    var Source:DataView = DataView((Application("Source")));
    ...
    MyDataGrid.DataSource = Source;
    ...
}

The advantage of this solution is that only the first request pays the price of retrieving the data. All subsequent requests use the already existing DataView object. As the data is never modified after initialization, you do not have to make any provisions for serializing access.
这个解决方法的优势是只有第一次请求给予取得数据。所有后来的请求使用已经存在的DataView对象。因为数据在初始化后再也没被修改过，你必须要解决连续访问的供应问题。

To provide individual data for a user during a session, data can be stored with session scope. In the following sample, values for user preferences are initialized in the Session_Start event in the Global.asax file.

为用户在session期间提供个人数据，数据能被session scope存储，下列例子中在Global.asax文件的Session_Start事件初始化用户参数。

void Session_Start() {
    Session["BackColor"] = "beige";
    ...
}

Sub Session_Start()
    Session("BackColor") = "beige"
    ...
End Sub

function Session_Start() : void {
    Session("BackColor") = "beige";
    ...
}

In the following customization page, values for user preferences are modified in the Submit_Click event handler according to user input.

下列定制页面中，在Submit_Click事件里依照用户输入来修改用户参数值。

protected void Submit_Click(Object sender, EventArgs e) {
    Session["BackColor"] = BackColor.Value;
    ...

    Response.Redirect(State["Referer"].ToString());
}

Protected Sub Submit_Click(sender As Object, e As EventArgs)
    Session("BackColor") = BackColor.Value
    ...

    Response.Redirect(State("Referer").ToString())
End Sub

protected function Submit_Click(sender:Object, e:EventArgs) : void {
    Session("BackColor") = BackColor.Value;
    ...

    Response.Redirect(State("Referer").ToString());
}

The individual values are retrieved using the GetStyle method:

用GetStyle方法取得个人数据。

protected String GetStyle(String key) {
    return Session[key].ToString();
}

Protected GetStyle(key As String) As String
    Return(Session(key).ToString())
End Sub

protected function GetStyle(key:String) : String {
    return Session(key).ToString();
}

The GetStyle method is used to construct session-specific styles:

GetStyle通常用来构建特殊的风格。

<style>
    body
    {
      font: <%=GetStyle("FontSize")%> <%=GetStyle("FontName")%>;
      background-color: <%=GetStyle("BackColor")%>;
    }
    a
    {
        color: <%=GetStyle("LinkColor")%>
    }
</style>

To verify that the values are really stored with session scope, open the sample page twice, then change one value in the first browser window and refresh the second one. The second window picks up the changes because both browser instances share a common Session object.

用session scope验证数据是否已经存在，打开两个页面，然后在第一个浏览器窗口改变一个值，并刷新第二个窗口。第二个窗口的内容也改变了因为两个浏览器实例共享一个公共的Session对象。

Configuring session state: Session state features can be configured via the <sessionState> section in a web.config file. To double the default timeout of 20 minutes, you can add the following to the web.config file of an application:

设置session state:Session state能由在web.config文件中<sessionState>部分设置。增加默认的超时时间（20分钟），你能添加下列各项到应用程序的web.config文件。

By default, ASP.NET will store the session state in the same process that processes the request, just as ASP does. If cookies are not available, a session can be tracked by adding a session identifier to the URL. This can be enabled by setting the following:

默认ASP.NET会在相同的处理请求过程中保存session state，正象ASP一样。如果cookies不能用，通过添加一个URL的session标识跟踪session。

ASP.NET can store session data in an external process, which can even reside on another machine. To enable this feature:

ASP.NET能在外部过程中存储session数据，甚至在其他的机器上。使用特点：

• Start the ASP.NET state service, either using the Services snap-in or by executing "net start aspnet_state" on the command line. The state service will by default listen on port 42424. To change the port, modify the registry key for the service: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSte\Services\aspnet_state\Parameters\Port
• Set the mode attribute of the <sessionState> section to "StateServer".
• Configure the stateConnectionString attribute with the values of the machine on which you started aspnet_state.

• 启动ASP.NET state 服务，使用Services snap-in或在命令行执行"net start aspnet_state"。state service会监听42424端口。可通过更改注册表中的HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSte\Services\aspnet_state\Parameters\Port来改变端口。
• 设置<sessionState>部分的mode属性为"StateServer"。
• 用启动aspnet_state的机器地址来配置stateConnectionString的属性。

下面的例子假设state service正在相同的机器上运行，象Web server（localhost）和使用默认端口（42424）：

<sessionState
  mode="StateServer"
  stateConnectionString="tcpip=localhost:42424"
/>

注意如果你想使用这个设置，你要重启WEB server（在命令行输入iisreset）并且session的值会保持。

ASP.NET provides the server-side notion of a view state for each control. A control can save its internal state between requests using the ViewState property on an instance of the class StateBag. The StateBag class provides a dictionary-like interface to store objects associated with a string key.

The file pagestate1.aspx displays one visible panel and stores the index of it in the view state of the page with the key PanelIndex:

protected void Next_Click(Object sender, EventArgs e ) {
    String PrevPanelId = "Panel" + ViewState["PanelIndex"].ToString();
    ViewState["PanelIndex"] = (int)ViewState["PanelIndex"] + 1;
    String PanelId = "Panel" + ViewState["PanelIndex"].ToString();
    ...
}

Protected Sub Next_Click(sender As Object, e As EventArgs)
    Dim PrevPanelId As String = "Panel" + ViewState("PanelIndex").ToString()
    ViewState("PanelIndex") = CType(ViewState("PanelIndex") + 1, Integer)
    Dim PanelId As String = "Panel" + ViewState("PanelIndex").ToString()
    ...
End Sub

protected function Next_Click(sender:Object, e:EventArgs) : void {
    var PrevPanelId:String = "Panel" + ViewState("PanelIndex").ToString();
    ViewState("PanelIndex") = int(ViewState("PanelIndex") + 1);
    var PanelId:String = "Panel" + ViewState("PanelIndex").ToString();
    ...
}

Note that if you open the page in several browser windows, each browser window will initially show the name panel. Each window can independently navigate between the panels.