Configuring NCache Output Caching Provider
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.
For Enterprise Edition:
<!-- 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="mypartitionofReplicaCache"
exceptionsEnabled="false"enableDetailLogs="false"
enableLogs="true"
writeExceptionsToEventLog="false"/>"
</providers>
</outputCache>
</caching>
For Professional and Open Source Editions:
<!-- 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=1448e8d1123e9096"
cacheName="mypartitionofReplicaCache"
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. For example, Version=4.6.0.0
.
Configuration Members
Members | Description |
---|---|
cacheName |
Requires string parameter. Specifies the name of the cache that has been configured through NCache Manager. The application will use this cache for caching specified pages. If no cache name is specified, a configuration exception will be thrown. |
exceptionsEnabled |
Optional Boolean attribute. Specifies whether exceptions from cache API are propagated to the page output. Setting this flag is especially helpful during development phase of application since exceptions provide more information about the specific causes of failure. The default value is false . |
enableLogs |
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 |
Optional Boolean attribute. When this flag is set, the information that is useful for debugging purposes will be included in 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. Duration
is specified in seconds.
<%@ OutputCache VaryByParam="ID" Duration="300">
Fetch Output Cache Data
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.GetByTag(new Alachisoft.NCache.Runtime.Caching.Tag("NC_ASP.net_output_data"));