Microsoft.Extensions.Caching.Memory 8.0.0

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Microsoft.Extensions.Caching.Memory --version 8.0.0                
NuGet\Install-Package Microsoft.Extensions.Caching.Memory -Version 8.0.0                
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="Microsoft.Extensions.Caching.Memory" Version="8.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Microsoft.Extensions.Caching.Memory --version 8.0.0                
#r "nuget: Microsoft.Extensions.Caching.Memory, 8.0.0"                
#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.
// Install Microsoft.Extensions.Caching.Memory as a Cake Addin
#addin nuget:?package=Microsoft.Extensions.Caching.Memory&version=8.0.0

// Install Microsoft.Extensions.Caching.Memory as a Cake Tool
#tool nuget:?package=Microsoft.Extensions.Caching.Memory&version=8.0.0                

About

Provides implementations for local and distributed in-memory cache. It stores and retrieves data in a fast and efficient way.

Key Features

  • A concrete implementation of the IMemoryCache interface, which represents a local in-memory cache that stores and retrieves data in a fast and efficient way
  • A distributed cache that supports higher scale-out than local cache
  • Expiration and eviction policies for its entries
  • Entry prioritization for when the cache size limit is exceeded and needs to be compacted by entry eviction
  • Track of cache statictics

How to Use

Use Microsoft.Extensions.Caching.Memory over System.Runtime.Caching when working with ASP.NET Core as it provides better integration support. For example, IMemoryCache works natively with ASP.NET Core dependency injection.

Local in-memory serialization:

using Microsoft.Extensions.Caching.Memory;

using MemoryCache cache = new(new MemoryCacheOptions());

object valueToCache = new();
string key = "key";

using (ICacheEntry entry = cache.CreateEntry(key))
{
    // Entries are committed after they are disposed therefore it does not exist yet.
    Console.WriteLine($"Exists: {cache.TryGetValue(key, out _)}\n");

    entry.Value = valueToCache;
    entry.SlidingExpiration = TimeSpan.FromSeconds(2);
}

bool exists = cache.TryGetValue(key, out object? cachedValue);
Console.WriteLine($"Exists: {exists}" );
Console.WriteLine($"cachedValue is valueToCache? {object.ReferenceEquals(cachedValue, valueToCache)}\n");

Console.WriteLine("Wait for the sliding expiration...");
Thread.Sleep(TimeSpan.FromSeconds(2));

Console.WriteLine("Exists: " + cache.TryGetValue(key, out _));

// You can also use the acceleration extensions to set and get entries
string key2 = "key2";
object value2 = new();

cache.Set("key2", value2);

object? cachedValue2 = cache.Get(key2);
Console.WriteLine($"cachedValue2 is value2? {object.ReferenceEquals(cachedValue2, value2)}");

Main Types

The main types provided by this library are:

  • Microsoft.Extensions.Caching.Memory.MemoryCache
  • Microsoft.Extensions.Caching.Memory.MemoryCacheOptions
  • Microsoft.Extensions.Caching.Distributed.MemoryDistributedCache
  • Microsoft.Extensions.Caching.Memory.MemoryDistributedCacheOptions

Additional Documentation

Microsoft.Extensions.Caching.Abstractions

Feedback & Contributing

Microsoft.Extensions.Caching.Memory is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 is compatible.  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 is compatible.  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. 
.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 is compatible.  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.

NuGet packages (2.3K)

Showing the top 5 NuGet packages that depend on Microsoft.Extensions.Caching.Memory:

Package Downloads
Microsoft.EntityFrameworkCore

Entity Framework Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations. EF Core works with SQL Server, Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and other databases through a provider plugin API. Commonly Used Types: Microsoft.EntityFrameworkCore.DbContext Microsoft.EntityFrameworkCore.DbSet

Microsoft.Data.SqlClient

The current data provider for SQL Server and Azure SQL databases. This has replaced System.Data.SqlClient. These classes provide access to SQL and encapsulate database-specific protocols, including tabular data stream (TDS). Commonly Used Types: Microsoft.Data.SqlClient.SqlConnection Microsoft.Data.SqlClient.SqlException Microsoft.Data.SqlClient.SqlParameter Microsoft.Data.SqlClient.SqlDataReader Microsoft.Data.SqlClient.SqlCommand Microsoft.Data.SqlClient.SqlTransaction Microsoft.Data.SqlClient.SqlParameterCollection Microsoft.Data.SqlClient.SqlClientFactory When using NuGet 3.x this package requires at least version 3.4.

Microsoft.ApplicationInsights.PerfCounterCollector

Application Insights Performance Counters Collector allows you to send data collected by Performance Counters to Application Insights. Privacy statement: https://go.microsoft.com/fwlink/?LinkId=512156

Microsoft.AspNetCore.Mvc.Razor

ASP.NET Core MVC Razor view engine for CSHTML files.

Microsoft.AspNetCore.Mvc.TagHelpers

ASP.NET Core MVC default tag helpers. Contains tag helpers for anchor tags, HTML input elements, caching, scripts, links (for CSS), and more. This package was built from the source code at https://github.com/aspnet/Mvc/tree/a6199bbfbab05583f987bae322fb04566841aaea

GitHub repositories (269)

Showing the top 5 popular GitHub repositories that depend on Microsoft.Extensions.Caching.Memory:

Repository Stars
jellyfin/jellyfin
The Free Software Media System
dotnet/efcore
EF Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations.
App-vNext/Polly
Polly is a .NET resilience and transient-fault-handling library that allows developers to express policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner. From version 6.0.1, Polly targets .NET Standard 1.1 and 2.0+.
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
Version Downloads Last updated
9.0.0-preview.7.24405.7 29,089 8/13/2024
9.0.0-preview.6.24327.7 79,267 7/9/2024
9.0.0-preview.5.24306.7 43,866 6/11/2024
9.0.0-preview.4.24266.19 44,160 5/21/2024
9.0.0-preview.3.24172.9 129,611 4/11/2024
9.0.0-preview.2.24128.5 68,009 3/12/2024
9.0.0-preview.1.24080.9 71,407 2/13/2024
8.0.0 69,211,415 11/14/2023
8.0.0-rc.2.23479.6 978,134 10/10/2023
8.0.0-rc.1.23419.4 261,902 9/12/2023
8.0.0-preview.7.23375.6 247,611 8/8/2023
8.0.0-preview.6.23329.7 148,590 7/11/2023
8.0.0-preview.5.23280.8 125,376 6/13/2023
8.0.0-preview.4.23259.5 123,655 5/16/2023
8.0.0-preview.3.23174.8 176,724 4/11/2023
8.0.0-preview.2.23128.3 194,620 3/14/2023
8.0.0-preview.1.23110.8 133,598 2/21/2023
7.0.0 120,726,495 11/7/2022
7.0.0-rc.2.22472.3 229,738 10/11/2022
7.0.0-rc.1.22426.10 233,497 9/14/2022
7.0.0-preview.7.22375.6 103,164 8/9/2022
7.0.0-preview.6.22324.4 74,288 7/12/2022
7.0.0-preview.5.22301.12 65,532 6/14/2022
7.0.0-preview.4.22229.4 77,324 5/10/2022
7.0.0-preview.3.22175.4 76,510 4/13/2022
7.0.0-preview.2.22152.2 85,537 3/14/2022
7.0.0-preview.1.22076.8 68,891 2/17/2022
6.0.1 207,035,582 2/8/2022
6.0.0 100,819,208 11/8/2021
6.0.0-rc.2.21480.5 456,031 10/12/2021
6.0.0-rc.1.21451.13 226,093 9/14/2021
6.0.0-preview.7.21377.19 93,663 8/10/2021
6.0.0-preview.6.21352.12 48,127 7/14/2021
6.0.0-preview.5.21301.5 182,474 6/15/2021
6.0.0-preview.4.21253.7 85,353 5/24/2021
6.0.0-preview.3.21201.4 97,393 4/8/2021
6.0.0-preview.2.21154.6 72,988 3/11/2021 6.0.0-preview.2.21154.6 is deprecated because it is no longer maintained.
6.0.0-preview.1.21102.12 364,423 2/12/2021 6.0.0-preview.1.21102.12 is deprecated because it is no longer maintained.
5.0.0 170,091,078 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.5 378,396 10/13/2020 5.0.0-rc.2.20475.5 is deprecated because it is no longer maintained.
5.0.0-rc.1.20451.14 322,587 9/14/2020 5.0.0-rc.1.20451.14 is deprecated because it is no longer maintained.
5.0.0-preview.8.20407.11 200,810 8/25/2020 5.0.0-preview.8.20407.11 is deprecated because it is no longer maintained.
5.0.0-preview.7.20364.11 116,382 7/21/2020 5.0.0-preview.7.20364.11 is deprecated because it is no longer maintained.
5.0.0-preview.6.20305.6 58,573 6/25/2020 5.0.0-preview.6.20305.6 is deprecated because it is no longer maintained.
5.0.0-preview.5.20278.1 6,293 6/10/2020 5.0.0-preview.5.20278.1 is deprecated because it is no longer maintained.
5.0.0-preview.4.20251.6 201,942 5/18/2020 5.0.0-preview.4.20251.6 is deprecated because it is no longer maintained.
5.0.0-preview.3.20215.2 116,059 4/23/2020 5.0.0-preview.3.20215.2 is deprecated because it is no longer maintained.
5.0.0-preview.2.20160.3 110,543 4/2/2020 5.0.0-preview.2.20160.3 is deprecated because it is no longer maintained.
5.0.0-preview.1.20120.4 62,073 3/16/2020 5.0.0-preview.1.20120.4 is deprecated because it is no longer maintained.
3.1.32 4,549,205 12/13/2022
3.1.31 879,525 11/8/2022
3.1.30 975,125 10/11/2022
3.1.29 1,218,219 9/13/2022
3.1.28 831,369 8/9/2022
3.1.27 876,254 7/12/2022
3.1.26 710,511 6/14/2022
3.1.25 1,147,692 5/10/2022
3.1.24 781,888 4/11/2022
3.1.23 1,478,713 3/8/2022
3.1.22 4,434,507 12/14/2021
3.1.21 3,373,085 11/7/2021
3.1.20 1,893,305 10/11/2021
3.1.19 2,602,741 9/14/2021
3.1.18 5,385,106 8/10/2021
3.1.17 2,286,441 7/13/2021
3.1.16 3,353,609 6/8/2021
3.1.15 3,440,052 5/11/2021
3.1.14 4,359,983 4/6/2021
3.1.13 5,341,326 3/9/2021
3.1.12 3,763,018 2/9/2021
3.1.11 6,329,553 1/12/2021
3.1.10 11,961,553 11/9/2020
3.1.9 16,420,837 10/13/2020
3.1.8 30,627,704 9/8/2020
3.1.7 16,005,321 8/11/2020
3.1.6 17,056,390 7/14/2020
3.1.5 17,226,808 6/9/2020
3.1.4 20,128,954 5/12/2020
3.1.3 30,782,568 3/24/2020
3.1.2 15,252,921 2/18/2020
3.1.1 23,945,870 1/14/2020
3.1.0 40,159,134 12/3/2019
3.1.0-preview3.19553.2 161,507 11/13/2019 3.1.0-preview3.19553.2 is deprecated because it is no longer maintained.
3.1.0-preview2.19525.4 31,953 11/1/2019 3.1.0-preview2.19525.4 is deprecated because it is no longer maintained.
3.1.0-preview1.19506.1 722,599 10/15/2019 3.1.0-preview1.19506.1 is deprecated because it is no longer maintained.
3.0.3 310,101 2/18/2020 3.0.3 is deprecated because it is no longer maintained.
3.0.2 94,661 1/14/2020 3.0.2 is deprecated because it is no longer maintained.
3.0.1 2,133,532 11/18/2019 3.0.1 is deprecated because it is no longer maintained.
3.0.0 36,105,564 9/23/2019 3.0.0 is deprecated because it is no longer maintained.
3.0.0-rc1.19456.10 46,284 9/16/2019 3.0.0-rc1.19456.10 is deprecated because it is no longer maintained.
3.0.0-preview9.19423.4 1,341,925 9/4/2019 3.0.0-preview9.19423.4 is deprecated because it is no longer maintained.
3.0.0-preview8.19405.4 391,886 8/13/2019 3.0.0-preview8.19405.4 is deprecated because it is no longer maintained.
3.0.0-preview7.19362.4 90,751 7/23/2019 3.0.0-preview7.19362.4 is deprecated because it is no longer maintained.
3.0.0-preview6.19304.6 172,628 6/12/2019 3.0.0-preview6.19304.6 is deprecated because it is no longer maintained.
3.0.0-preview5.19227.9 626,130 5/6/2019 3.0.0-preview5.19227.9 is deprecated because it is no longer maintained.
3.0.0-preview4.19216.2 22,685 4/18/2019 3.0.0-preview4.19216.2 is deprecated because it is no longer maintained.
3.0.0-preview3.19153.1 211,520 3/6/2019 3.0.0-preview3.19153.1 is deprecated because it is no longer maintained.
3.0.0-preview.19074.2 32,057 1/29/2019 3.0.0-preview.19074.2 is deprecated because it is no longer maintained.
3.0.0-preview.18572.1 52,195 12/3/2018 3.0.0-preview.18572.1 is deprecated because it is no longer maintained.
2.2.0 148,983,893 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 241,786 10/17/2018 2.2.0-preview3-35497 is deprecated because it is no longer maintained.
2.2.0-preview2-35157 171,350 9/12/2018 2.2.0-preview2-35157 is deprecated because it is no longer maintained.
2.2.0-preview1-35029 100,991 8/22/2018 2.2.0-preview1-35029 is deprecated because it is no longer maintained.
2.1.23 18,913,327 10/13/2020
2.1.2 32,460,921 8/21/2018
2.1.1 46,589,231 6/18/2018
2.1.0 65,164,270 5/29/2018
2.1.0-rc1-final 250,770 5/6/2018 2.1.0-rc1-final is deprecated because it is no longer maintained.
2.1.0-preview2-final 239,822 4/10/2018 2.1.0-preview2-final is deprecated because it is no longer maintained.
2.1.0-preview1-final 391,975 2/26/2018 2.1.0-preview1-final is deprecated because it is no longer maintained.
2.0.2 10,721,634 5/7/2018 2.0.2 is deprecated because it is no longer maintained.
2.0.1 16,889,255 3/13/2018 2.0.1 is deprecated because it is no longer maintained.
2.0.0 104,545,433 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 132,223 6/28/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 1,054,191 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.2 8,002,840 5/9/2017 1.1.2 is deprecated because it is no longer maintained.
1.1.1 16,720,464 3/6/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 9,010,636 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 69,673 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.2 4,115,111 3/6/2017 1.0.2 is deprecated because it is no longer maintained.
1.0.1 623,593 12/12/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 231,729,072 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 277,991 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.
1.0.0-rc1-final 509,232 11/18/2015 1.0.0-rc1-final is deprecated because it is no longer maintained.