UserControl.Cache Property

Definition

Gets the Cache object that is associated with the application that contains the user control.

public:
 property System::Web::Caching::Cache ^ Cache { System::Web::Caching::Cache ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.Caching.Cache Cache { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Cache : System.Web.Caching.Cache
Public ReadOnly Property Cache As Cache

Property Value

The Cache object in which to store the user control's data.

Attributes

Examples

The following example uses the Cache property to store the Text property value of a Label Web server control, txtValue, in the Cache object associated with the user control's application. It uses the Cache property to do so, assigning the item a key parameter value of txtName.Text.

Important

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

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

Private Sub cmdAdd_Click(objSender As Object, objArgs As EventArgs)
  If txtName.Text <> "" Then
    ' Add this item to the cache.
  Cache(txtName.Text) = txtValue.Text
  End If
End Sub

Remarks

The Cache allows you to store data for later retrieval, and is shared across the application. The data that you store is independent of the current page or user session. Access data through this property to boost page or application performance if creating the data is slow. For more information about using the Cache, see Caching Application Data.

Applies to

See also