NCache.Microsoft.Extensions.Caching 5.3.800

NCache.Microsoft.Extensions.Caching

An implementation of Microsoft.Extensions.Caching backed by NCache, allowing ASP.NET Core and .NET applications to use NCache as a distributed cache with minimal code changes. It integrates seamlessly with the Microsoft.Extensions.Caching.Distributed.IDistributedCache abstraction, making it a drop-in replacement for in-memory caching or other distributed cache providers — and can also be used for ASP.NET Core Response Caching.

Installation

Install-Package NCache.Microsoft.Extensions.Caching

or, using the .NET CLI:

dotnet add package NCache.Microsoft.Extensions.Caching

Prerequisites

• .NET 6.0+ or .NETFramework4.6.2+ Application.
• NCache SDK 5.3.800 or later.
• An NCache 5.3.800 (or later) server should be up and running, with the target cache already created/registered on it.

Getting Started

Setting up NCache

1. Open your application's configuration file:
   • .NET / ASP.NET Core: appsettings.json
   • .NET Framework / ASP.NET: app.config or web.config
2. Add an entry for the cache you created on the NCache server, keyed by the cache's name. The example uses defaultCache; replace it with your cache's name.
3. Set server to one or more nodes of the cluster where that cache is running. Separate multiple nodes with commas.

appsettings.json

{
  "ncache": {
    "defaultCache": {
      "server": "20.200.20.24,20.200.20.25",
      "port": 9800
    }
  }
}

app.config / web.config

<configuration>
  <configSections>
    <section name="ncache" type="Alachisoft.NCache.Client.NCacheSection, Alachisoft.NCache.Client" />
  </configSections>
  <ncache>
    <caches>
      <add name="defaultCache" server="20.200.20.24,20.200.20.25" port="9800" />
    </caches>
  </ncache>
</configuration>

The cache name in the configuration must match the name you pass in code:

ICache cache = CacheManager.GetCache("defaultCache");

Setting up Package

1. Register NCache as the application's distributed cache provider in Program.cs:

   builder.Services.AddNCacheDistributedCache(options =>
   {
       options.CacheName = "YourCacheName";
       options.EnableLogs = false;
       options.ExceptionsEnabled = true;
   });
   

2. Inject IDistributedCache anywhere in your application to use the cache:

   using Microsoft.Extensions.Caching.Distributed;
   
   public class ProductService
   {
       private readonly IDistributedCache _cache;
   
       public ProductService(IDistributedCache cache)
       {
           _cache = cache;
       }
   
       public async Task SetValueAsync()
       {
           await _cache.SetStringAsync(
               "product:1",
               "Laptop",
               new DistributedCacheEntryOptions
               {
                   AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(10)
               });
       }
   
       public async Task<string?> GetValueAsync()
       {
           return await _cache.GetStringAsync("product:1");
       }
   }
   

   The implementation supports all standard IDistributedCache operations: Get() / GetAsync(), Set() / SetAsync(), Refresh() / RefreshAsync(), and Remove() / RemoveAsync().

Resources

• NCache Integration Docs
• Client SDK Docs
• Sample Code on GitHub
• Programmer's Guide

Technical Support

Alachisoft provides various technical support resources.

Visit the Alachisoft Support Center to select a support resource appropriate for your issue. To request additional features or report a documentation discrepancy, contact support@alachisoft.com.

License

Copyright © 2026 Alachisoft. All rights reserved.