This documentation is archived and is not being maintained.

Page.Cache Property

Gets the Cache object associated with the application in which the page resides.

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

'Declaration
<BrowsableAttribute(False)> _
Public ReadOnly Property Cache As Cache
'Usage
Dim instance As Page 
Dim value As Cache 

value = instance.Cache

Property Value

Type: System.Web.Caching.Cache
The Cache associated with the page's application.

ExceptionCondition
HttpException

An instance of Cache is not created.

An application's Cache object allows you to store and retrieve arbitrary data on subsequent requests. The cache is not specifically associated with a page or user session. It is used primarily to enhance application performance. For more information, see Caching Application Data. For more information on the difference between application caching and page output caching, see ASP.NET Caching Overview.

The following code example inserts the sum of two integers into the System.Web.Caching.Cache object using the Page.Cache property. It then retrieves the value using the Cache.Get method and writes it to a Label Web server control.

' This is a simple page that demonstrates how to place a value 
' in the cache from a page, and one way to retrieve the value. 
' Declare two constants, myInt1 and myInt2 and set their values 
' and declare a string variable, myValue. 
Const myInt1 As Integer = 35
Const myInt2 As Integer = 77
Dim myValue As String 


' When the page is loaded, the sum of the constants 
' is placed in the cache and assigned a key, key1. 
Sub Page_Load(sender As [Object], arg As EventArgs)
   Cache("key1")= myInt1 + myInt2
End Sub 'Page_Load


' When a user clicks a button, the sum associated 
' with key1 is retrieved from the Cache using the  
' Cache.Get method. It is converted to a string 
' and displayed in a Label Web server control. 
Sub CacheBtn_Click(sender As Object, e As EventArgs)
  If Cache("key1") Is Nothing Then
   myLabel.Text = "That object is not cached." 
  Else
   myValue = Cache.Get("key1").ToString()
   myLabel.Text = myValue
  End If 
End Sub 'CacheBtn_Click

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
Show: