VIEApps.Enyim.Caching 9.0.2503.2

.NET 9.0 .NET Standard 2.0

dotnet add package VIEApps.Enyim.Caching --version 9.0.2503.2

NuGet\Install-Package VIEApps.Enyim.Caching -Version 9.0.2503.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="VIEApps.Enyim.Caching" Version="9.0.2503.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="VIEApps.Enyim.Caching" Version="9.0.2503.2" />
                    

                            Directory.Packages.props

<PackageReference Include="VIEApps.Enyim.Caching" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add VIEApps.Enyim.Caching --version 9.0.2503.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: VIEApps.Enyim.Caching, 9.0.2503.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#addin nuget:?package=VIEApps.Enyim.Caching&version=9.0.2503.2
                    

                            Install VIEApps.Enyim.Caching as a Cake Addin

#tool nuget:?package=VIEApps.Enyim.Caching&version=9.0.2503.2
                    

                            Install VIEApps.Enyim.Caching as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

VIEApps.Enyim.Caching

The memcached client library on .NET 5 & .NET Standard 2.0:

100% compatible with EnyimMemcached 2.x
Fully async (EnyimMemcached still blocks threads while reading from sockets/response)
Multiple nodes supported with Ketama for better distribution
Object serialization by various transcoders: Json.NET Bson, Protocol Buffers, MessagePack
Ready with .NET Core 2.x+/.NET Framework 4.6.1+ with more useful methods (Set, Add, Replace, Refresh, Exists)

NuGet

Information

Migrated from the fork EnyimMemcachedCore (.NET Core 2.0)
Reference from the original EnyimMemcached (.NET Framework 3.5)

Usage of ASP.NET Core 2.x+ apps

Add services.AddMemcached(...) and app.UseMemcached() in Startup.cs
Add IMemcachedClient or IDistributedCache into constructor (using dependency injection)

Configure (by the appsettings.json file) without authentication

{
	"Memcached": {
		"Servers": [
		{
			"Address": "192.168.0.2",
			"Port": 11211
		},
		{
			"Address": "192.168.0.3",
			"Port": 11211
		}],
		"SocketPool": {
			"MinPoolSize": 10,
			"MaxPoolSize": 100,
			"DeadTimeout": "00:01:00",
			"ConnectionTimeout": "00:00:05",
			"ReceiveTimeout": "00:00:01"
		}
	}
}

Configure (by the appsettings.json file) with authentication

{
	"Memcached": {
		"Servers": [
		{
			"Address": "192.168.0.2",
			"Port": 11211
		},
		{
			"Address": "192.168.0.3",
			"Port": 11211
		}],
		"SocketPool": {
			"MinPoolSize": 10,
			"MaxPoolSize": 100,
			"DeadTimeout": "00:01:00",
			"ConnectionTimeout": "00:00:05",
			"ReceiveTimeout": "00:00:01"
		},
		"Authentication": {
			"Type": "Enyim.Caching.Memcached.PlainTextAuthenticator, Enyim.Caching",
			"Parameters": {
				"zone": "",
				"userName": "username",
				"password": "password"
			}
		}
	}
}

Startup.cs

public class Startup
{
	public void ConfigureServices(IServiceCollection services)
	{
		// ....
		services.AddMemcached(options => Configuration.GetSection("Memcached").Bind(options));
	}
	
	public void Configure(IApplicationBuilder app, IHostingEnvironment env)
	{ 
		// ....
		app.UseMemcached();
	}
}

Use IMemcachedClient interface

public class TabNavService
{
	ITabNavRepository _tabNavRepository;
	IMemcachedClient _cache;

	public TabNavService(ITabNavRepository tabNavRepository, IMemcachedClient cache)
	{
		_tabNavRepository = tabNavRepository;
		_cache = cache;
	}

	public async Task<IEnumerable<TabNav>> GetAllAsync()
	{
		var cacheKey = "aboutus_tabnavs_all";
		var result = await _cache.GetAsync<IEnumerable<TabNav>>(cacheKey);
		if (result == null)
		{
			var tabNavs = await _tabNavRepository.GetAll();
			await _cache.SetAsync(cacheKey, tabNavs, TimeSpan.FromMinutes(30));
			return tabNavs;
		}
		else
			return result;
	}
}

Use IDistributedCache interface

public class CreativeService
{
	ICreativeRepository _creativeRepository;
	IDistributedCache _cache;

	public CreativeService(ICreativeRepository creativeRepository, IDistributedCache cache)
	{
		_creativeRepository = creativeRepository;
		_cache = cache;
	}

	public async Task<IList<CreativeDTO>> GetCreativesAsync(string unitName)
	{
		var cacheKey = $"creatives_{unitName}";
		IList<CreativeDTO> creatives = null;

		var creativesBytes = await _cache.GetAsync(cacheKey);
		var creativesJson = creativesBytes != null ? System.Text.Encoding.UTF8.GetString(creativesBytes) : null;
		if (creativesJson == null)
		{
			creatives = await _creativeRepository.GetCreatives(unitName).ProjectTo<CreativeDTO>().ToListAsync();
			var json = creatives != null && creatives.Count() > 0 ? JsonConvert.SerializeObject(creatives) : string.Empty;
			creativesBytes = System.Text.Encoding.UTF8.GetBytes(json);
			await _cache.SetAsync(cacheKey, creativesBytes, new DistributedCacheEntryOptions().SetSlidingExpiration(TimeSpan.FromMinutes(30)));
		}
		else
			creatives = JsonConvert.DeserializeObject<List<CreativeDTO>>(creativesJson);

		return creatives;
	}
}

Usage of .NET Core 2.x+/.NET Framework 4.6.1+ standalone apps

Configure (by the app.config/web.config) without authentication

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<configSections>
		<section name="memcached" type="Enyim.Caching.Configuration.MemcachedClientConfigurationSectionHandler, Enyim.Caching" />
	</configSections>
	<memcached>
		<servers>
			<add address="192.168.0.2" port="11211" />
			<add address="192.168.0.3" port="11211" />
		</servers>
		<socketPool minPoolSize="10" maxPoolSize="100" deadTimeout="00:01:00" connectionTimeout="00:00:05" receiveTimeout="00:00:01" />
	</memcached>
</configuration>

Configure (by the app.config/web.config) with authentication

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<configSections>
		<section name="memcached" type="Enyim.Caching.Configuration.MemcachedClientConfigurationSectionHandler, Enyim.Caching" />
	</configSections>
	<memcached>
		<servers>
			<add address="192.168.0.2" port="11211" />
			<add address="192.168.0.3" port="11211" />
		</servers>
		<socketPool minPoolSize="10" maxPoolSize="100" deadTimeout="00:01:00" connectionTimeout="00:00:05" receiveTimeout="00:00:01" />
		<authentication type="Enyim.Caching.Memcached.PlainTextAuthenticator, Enyim.Caching" zone="" userName="username" password="password" />
	</memcached>
</configuration>

Example

public class CreativeService
{
	MemcachedClient _cache;

	public CreativeService()
	{
		_cache = new MemcachedClient(ConfigurationManager.GetSection("memcached") as MemcachedClientConfigurationSectionHandler);
	}

	public async Task<IList<CreativeDTO>> GetCreativesAsync(string unitName)
	{
		return await _cache.GetAsync<IList<CreativeDTO>>($"creatives_{unitName}");
	}
}

Other transcoders (Protocol Buffers, Json.NET Bson, MessagePack)

See VIEApps.Enyim.Caching.Transcoders

Need a library for working with other distributed cache (Redis) in the same time?

See VIEApps.Components.Caching

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 was computed.
.NET Framework	net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETStandard 2.0
- Microsoft.AspNetCore.Http.Abstractions (>= 2.3.0)
- Microsoft.Extensions.Caching.Abstractions (>= 9.0.3)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.3)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.3)
- Microsoft.Extensions.DependencyModel (>= 9.0.3)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.3)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.3)
- Microsoft.IO.RecyclableMemoryStream (>= 3.0.1)
- MsgPack.Cli (>= 1.0.1)
- Newtonsoft.Json (>= 13.0.3)
- Newtonsoft.Json.Bson (>= 1.0.3)
- System.Configuration.ConfigurationManager (>= 9.0.3)
- System.Runtime.Loader (>= 4.3.0)
net9.0
- Microsoft.Extensions.Caching.Abstractions (>= 9.0.3)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.3)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.3)
- Microsoft.Extensions.DependencyModel (>= 9.0.3)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.3)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 9.0.3)
- Microsoft.IO.RecyclableMemoryStream (>= 3.0.1)
- MsgPack.Cli (>= 1.0.1)
- Newtonsoft.Json (>= 13.0.3)
- Newtonsoft.Json.Bson (>= 1.0.3)
- System.Configuration.ConfigurationManager (>= 9.0.3)

NuGet packages (5)

Showing the top 5 NuGet packages that depend on VIEApps.Enyim.Caching:

Package	Downloads
VIEApps.Components.Caching Distributed cache (Redis & Memcached) on .NET	273.0K
VIEApps.Enyim.Caching.Transcoders The custom transcoders for VIEApps Enyim Caching (Json.NET Bson, MessagePack and Protocol Buffers)	74.8K
PipServices.Memcached Memcached components for Pip.Services in .NET	2.8K
PipServices3.Memcached Memcached components for Pip.Services in .NET	1.8K
PipServices4.Memcached Memcached components for Pip.Services in .NET	226

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
9.0.2503.2	254	3/21/2025
9.0.2503.1	318	3/1/2025
9.0.2501.2	944	1/24/2025
9.0.2501.1	1,022	12/31/2024
9.0.2412.1	302	12/9/2024
9.0.2411.1	719	11/18/2024
8.0.2410.1	903	10/2/2024
8.0.2408.1	3,632	8/1/2024
8.0.2407.1	1,919	6/22/2024
8.0.2406.2	764	5/30/2024
8.0.2406.1	278	5/30/2024
8.0.2404.1	2,171	5/9/2024
8.0.2312.1	5,952	12/22/2023
8.0.2311.1	821	11/16/2023
8.0.2310.2	414	10/25/2023
8.0.2310.1	447	9/30/2023
8.0.2309.1	408	9/8/2023
8.0.2308.1	416	8/29/2023
7.0.2307.1	7,959	7/6/2023
7.0.2306.1	800	6/6/2023
7.0.2305.1	2,793	5/17/2023
7.0.2303.2	1,655	3/17/2023
7.0.2303.1	1,024	3/2/2023
7.0.2302.1	2,831	1/31/2023
7.0.2301.1	1,696	1/1/2023
7.0.2212.1	2,356	11/30/2022
7.0.2211.1	345	11/27/2022
6.0.2211.1	3,232	11/9/2022
5.0.2211.1	1,924	11/5/2022
5.0.2209.1	3,944	9/20/2022
5.0.2207.1	4,782	7/18/2022
5.0.2205.6	44,675	5/6/2022
5.0.2205.3	2,271	5/5/2022
5.0.2205.1	3,201	4/30/2022
5.0.2204.2	2,703	4/12/2022
5.0.2204.1	2,373	4/10/2022
5.0.2203.5	15,235	3/16/2022
5.0.2203.4	2,941	3/14/2022
5.0.2203.3	3,045	3/10/2022
5.0.2203.2	2,954	3/10/2022
5.0.2203.1	2,757	3/5/2022
5.0.2201.1	18,019	1/3/2022
4.0.2112.1	2,532	12/3/2021
4.0.2111.1	15,246	11/2/2021
4.0.2110.3	3,553	10/13/2021
4.0.2110.2	2,353	9/30/2021
4.0.2110.1	1,911	9/30/2021
4.0.2109.7	2,035	9/22/2021
4.0.2109.6	2,120	9/20/2021
4.0.2109.5	2,000	9/17/2021
4.0.2109.3	2,720	9/16/2021
4.0.2109.2	2,248	9/13/2021
4.0.2109.1	2,053	9/3/2021
4.0.2108.3	2,446	8/2/2021
4.0.2108.2	2,375	8/1/2021
4.0.2108.1	3,547	7/26/2021
4.0.2107.2	2,153	7/17/2021
4.0.2107.1	2,760	7/1/2021
4.0.2106.2	1,939	6/8/2021
4.0.2106.1	2,098	6/6/2021
4.0.2105.1	2,137	5/3/2021
4.0.2104.1	1,835	4/4/2021
4.0.2103.1	2,259	3/9/2021
4.0.2102.2	2,398	2/11/2021
4.0.2102.1	2,093	2/1/2021
3.1.2102.1	974	1/20/2021
3.0.2101.1	2,425	12/31/2020
2.0.2012.4	3,906	12/18/2020
2.0.2012.3	2,796	12/17/2020
2.0.2012.1	2,488	12/16/2020
1.8.2012.1	3,537	12/3/2020
1.8.2011.2	3,174	11/15/2020
1.8.2011.1	2,573	11/11/2020
1.7.2010.1	22,437	10/24/2020
1.7.2009.3	70,075	9/9/2020
1.7.2009.2	1,941	9/3/2020
1.7.2009.1	1,995	9/2/2020
1.7.2008.3	2,024	8/21/2020
1.7.2008.2	3,676	8/12/2020
1.7.2008.1	2,519	8/3/2020
1.7.2007.2	2,807	7/15/2020
1.7.2007.1	2,886	6/30/2020
1.7.2006.2	3,086	6/10/2020
1.7.2006.1	2,846	6/2/2020
1.7.2005.2	3,186	5/20/2020
1.7.2005.1	3,693	5/13/2020
1.7.2004.24	2,713	4/24/2020
1.7.2004.1	2,749	3/31/2020
1.7.2003.4	3,009	3/7/2020
1.7.2003.3	2,698	3/5/2020
1.7.2003.2	2,851	3/3/2020
1.7.2002.5	5,907	2/20/2020
1.7.2002.4	2,833	2/19/2020
1.7.2002.3	2,849	2/11/2020
1.7.2002.2	2,879	2/3/2020
1.7.2002.1	2,908	2/2/2020
1.7.2001.4	2,972	1/19/2020
1.7.2001.3	2,908	1/17/2020
1.7.2001.2	6,265	1/6/2020
1.7.2001.1	1,767	1/2/2020
1.7.1912.3	2,774	12/6/2019
1.7.1912.2	1,753	12/4/2019
1.7.1912.1	1,776	12/1/2019
1.7.1911.1	8,478	10/28/2019
1.7.1910.4	3,093	10/17/2019
1.7.1910.3	2,906	10/9/2019
1.7.1910.2	3,831	10/1/2019
1.7.1910.1	2,564	9/26/2019
1.6.1906.2	15,664	6/12/2019
1.6.1906.1	2,717	5/22/2019
1.6.1905.1	2,779	5/7/2019
1.6.1904.3	3,418	4/11/2019
1.6.1904.1	2,314	3/29/2019
1.6.1902.1	6,131	1/31/2019
1.5.1901.2	52,140	1/11/2019
1.5.1901.1	1,713	1/4/2019
1.5.1812.2	2,038	12/4/2018
1.5.1812.1	2,546	12/2/2018
1.5.1811.1	2,112	11/23/2018
1.5.1810.2	1,941	10/25/2018
1.5.1810.1	2,087	10/8/2018
1.5.5.1809	10,062	9/10/2018
1.5.4.1808	5,423	7/24/2018
1.5.3.1806	2,611	5/31/2018
1.5.2.1806	2,369	5/28/2018
1.5.1.1806	2,124	5/17/2018
1.5.0.1805	3,117	5/6/2018
1.4.5.1805	3,989	4/27/2018
1.4.4.1804	1,506	4/11/2018
1.4.3.1802	52,468	2/22/2018
1.4.2.1802	4,977	1/31/2018
1.4.1.1801	3,091	1/5/2018
1.4.0.1801	2,925	12/25/2017
1.3.0.1712	2,807	11/26/2017
1.2.0.1712	2,496	11/10/2017
1.1.2.1711	2,525	11/1/2017
1.1.0	3,162	10/28/2017
1.0.0.1	1,685	10/27/2017

Latest components