This documentation is archived and is not being maintained.

Cache.Item Property

Gets or sets the cache item at the specified key.

Namespace:  System.Web.Caching
Assembly:  System.Web (in System.Web.dll)

public Object this[
	string key
] { get; set; }


Type: System.String

A String object that represents the key for the cache item.

Property Value

Type: System.Object
The specified cache item.

You can use this property to retrieve the value of a specified cache item, or to add an item and a key for it to the cache. Adding a cache item using the Item property is equivalent to calling the Cache.Insert method.

The following example uses the Item property to retrieve the value of a cached object associated with the Key1 key. It then uses the HttpResponse.Write method to write the value and introductory text and the B HTML element to a Web Forms page.

Response.Write("Value of cache key: <B>" + Server.HtmlEncode(Cache["Key1"] as string) + "</B>");

The following example demonstrates using this property to insert the value of a text box into the cache.

private void cmdAdd_Click(Object objSender, EventArgs objArgs)
    if (txtName.Text != "")
        // Add this item to the cache.
        Cache[txtName.Text] = txtValue.Text;

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0