ASP.NET in a Nutshell

Name

Items

Synopsis

Context.Items(Name as String) = Value
Value = Context.Items(Index as Integer)
Value = Context.Items(Name as String)

The Items collection is a key-value collection that can contain any object the developer wishes to save for, at most, the duration of the request. Unlike Session- or Application-level collections that can be used to store values, this collection does not survive past the current request. This collection is the ideal place to store values that need not survive past the current request, especially if the items need to be stored or retrieved in places where the Session or Application objects are not available.

Parameters

Name

The key name for the value to be stored.

Value

The object to be stored in the Items collection, or the value to be retrieved.

Index

The index of the value to be retrieved.

Example

The example adds two values to the Context.Items collection. The first is added traditionally, referring to the key in the Items collection directly. The second is added using the Item’s collection’s Add method. Finally, the Message label control displays whether the “Foo” value has been set. To display the string key used, you need to use two double quotes, which displays as the literal quote character. In C#, the quote character would need to be escaped by placing a backslash (\) in front of it.

Sub Page_Load( ) Context.Items("Foo")="Bar" Context.Items.Add("Bar","Foo") Message.Text = "Context.Items.Contains(""Foo"") is " & _ Context.Items.Contains("Foo") ...