ASP.NET Output Cache Provider Overview

In order to configure NCache Output Caching Provider, please follow the steps below:

Prerequisites

• .NET/.NET Core

• Install the following NuGet packages in your application based on your NCache version:
  • Enterprise: AspNet.OutputCache.NCache
  • Professional: AspNet.OutputCache.NCache.Professional
• To utilize the extension, include the following namespaces in your application in Startup.cs:
  • Alachisoft.NCache.OutputCacheProvider
• The cache must be running.
• For API details, refer to: NOutputCacheProvider, GetByTag.
• Make sure that the data being added is serializable.
• To ensure the operation is fail-safe, it is recommended to handle any potential exceptions within your application, as explained in Handling Failures.
• To handle any unseen exceptions, refer to the Troubleshooting section.

Step 1: Register NCache as ASP.NET Output Cache Provider

In Web.config of your application, under the section of system.web element add NCache provider as a default provider, i.e.;

<!-- caching section group -->

<caching>
  <outputCache defaultProvider ="NOutputCacheProvider">
    <providers>
    <add name="NOutputCacheProvider" 
         type= "Alachisoft.NCache.OutputCacheProvider.NOutputCacheProvider, Alachisoft.NCache.OutputCacheProvider, Version=x.x.x.x, Culture=neutral, PublicKeyToken=cff5926ed6a53769" 
         cacheName="demoCache" 
         exceptionsEnabled="false"
         enableDetailLogs="false" 
         enableLogs="true" 
         writeExceptionsToEventLog="false"/>"
    </providers>
  </outputCache>
</caching>

Note

Replace Version=x.x.x.x with the actual NCache version that you have installed.

Configuration Members

Members	Description
cacheName	Specifies the name of the cache that has been configured through NCache Manager. The application will use this cache for caching specified pages. It requires a string parameter and if no cache name is specified, a configuration exception will be thrown.
exceptionsEnabled	It is an optional Boolean attribute that specifies whether exceptions from cache API are propagated to the page output. Setting this flag is especially helpful during the development phase of the application since exceptions provide more information about the specific causes of failure. The default value is False.
enableLogs	It is an optional Boolean attribute. When this flag is set, all important events are logged including exceptions, cache initialized, disposed, and session not found, etc. The default value is False.
enableDetailLogs	It is an Optional Boolean attribute. When this flag is set, the information that is useful for debugging purposes will be included in the logs. The default value is False.

Step 2: Add ASP.NET Output Cache Tag To Specific Pages

Add the under-mentioned OutputCache tag to those pages whose output you want to cache. It's duration is specified in seconds.

<%@ OutputCache VaryByParam="ID" Duration="300">

Fetch Output Cache Data

Note

Tags are only available in NCache Enterprise.

Output cache data can be retrieved by NC_ASP.net_output_data tag. With this tag, it is easy to find data specific to Output Caching data.

Hashtable allOutputCacheData = cache.SearchService.GetByTag(new Tag("NC_ASP.net_output_data"));

See Also

Using Output Cache with Custom Hooks
View State Caching
ASP.NET Core