Microsoft.Extensions.Caching.Memory 8.0.1

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.1                
NuGet\Install-Package Microsoft.Extensions.Caching.Memory -Version 8.0.1                
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.1" />                
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.1                
#r "nuget: Microsoft.Extensions.Caching.Memory, 8.0.1"                
#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.1

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

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.5K)

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.EntityFrameworkCore.Relational

Shared Entity Framework Core components for relational database providers.

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.EntityFrameworkCore.SqlServer

Microsoft SQL Server database provider for Entity Framework Core.

Microsoft.EntityFrameworkCore.Design

Shared design-time components for Entity Framework Core tools.

GitHub repositories (271)

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-rc.2.24473.5 72,229 10/8/2024
9.0.0-rc.1.24431.7 81,773 9/10/2024 9.0.0-rc.1.24431.7 has at least one vulnerability with high severity.
9.0.0-preview.7.24405.7 66,220 8/13/2024 9.0.0-preview.7.24405.7 has at least one vulnerability with high severity.
9.0.0-preview.6.24327.7 119,940 7/9/2024 9.0.0-preview.6.24327.7 has at least one vulnerability with high severity.
9.0.0-preview.5.24306.7 57,910 6/11/2024 9.0.0-preview.5.24306.7 has at least one vulnerability with high severity.
9.0.0-preview.4.24266.19 56,152 5/21/2024 9.0.0-preview.4.24266.19 has at least one vulnerability with high severity.
9.0.0-preview.3.24172.9 154,738 4/11/2024 9.0.0-preview.3.24172.9 has at least one vulnerability with high severity.
9.0.0-preview.2.24128.5 73,372 3/12/2024 9.0.0-preview.2.24128.5 has at least one vulnerability with high severity.
9.0.0-preview.1.24080.9 80,040 2/13/2024 9.0.0-preview.1.24080.9 has at least one vulnerability with high severity.
8.0.1 4,125,449 10/8/2024
8.0.0 95,669,633 11/14/2023 8.0.0 has at least one vulnerability with high severity.
8.0.0-rc.2.23479.6 1,111,996 10/10/2023 8.0.0-rc.2.23479.6 has at least one vulnerability with high severity.
8.0.0-rc.1.23419.4 289,860 9/12/2023 8.0.0-rc.1.23419.4 has at least one vulnerability with high severity.
8.0.0-preview.7.23375.6 308,063 8/8/2023 8.0.0-preview.7.23375.6 has at least one vulnerability with high severity.
8.0.0-preview.6.23329.7 164,564 7/11/2023 8.0.0-preview.6.23329.7 has at least one vulnerability with high severity.
8.0.0-preview.5.23280.8 131,311 6/13/2023 8.0.0-preview.5.23280.8 has at least one vulnerability with high severity.
8.0.0-preview.4.23259.5 130,215 5/16/2023 8.0.0-preview.4.23259.5 has at least one vulnerability with high severity.
8.0.0-preview.3.23174.8 190,688 4/11/2023 8.0.0-preview.3.23174.8 has at least one vulnerability with high severity.
8.0.0-preview.2.23128.3 199,539 3/14/2023 8.0.0-preview.2.23128.3 has at least one vulnerability with high severity.
8.0.0-preview.1.23110.8 136,031 2/21/2023 8.0.0-preview.1.23110.8 has at least one vulnerability with high severity.
7.0.0 129,824,345 11/7/2022
7.0.0-rc.2.22472.3 234,339 10/11/2022
7.0.0-rc.1.22426.10 238,400 9/14/2022
7.0.0-preview.7.22375.6 107,011 8/9/2022
7.0.0-preview.6.22324.4 76,370 7/12/2022
7.0.0-preview.5.22301.12 66,807 6/14/2022
7.0.0-preview.4.22229.4 78,935 5/10/2022
7.0.0-preview.3.22175.4 77,869 4/13/2022
7.0.0-preview.2.22152.2 86,331 3/14/2022
7.0.0-preview.1.22076.8 70,956 2/17/2022
6.0.2 261,234 10/8/2024
6.0.1 217,335,334 2/8/2022 6.0.1 has at least one vulnerability with high severity.
6.0.0 106,597,249 11/8/2021 6.0.0 has at least one vulnerability with high severity.
6.0.0-rc.2.21480.5 478,211 10/12/2021 6.0.0-rc.2.21480.5 has at least one vulnerability with high severity.
6.0.0-rc.1.21451.13 239,061 9/14/2021 6.0.0-rc.1.21451.13 has at least one vulnerability with high severity.
6.0.0-preview.7.21377.19 95,219 8/10/2021 6.0.0-preview.7.21377.19 has at least one vulnerability with high severity.
6.0.0-preview.6.21352.12 48,686 7/14/2021 6.0.0-preview.6.21352.12 has at least one vulnerability with high severity.
6.0.0-preview.5.21301.5 184,832 6/15/2021 6.0.0-preview.5.21301.5 has at least one vulnerability with high severity.
6.0.0-preview.4.21253.7 85,937 5/24/2021 6.0.0-preview.4.21253.7 has at least one vulnerability with high severity.
6.0.0-preview.3.21201.4 98,604 4/8/2021 6.0.0-preview.3.21201.4 has at least one vulnerability with high severity.
6.0.0-preview.2.21154.6 73,951 3/11/2021 6.0.0-preview.2.21154.6 is deprecated because it is no longer maintained; 6.0.0-preview.2.21154.6 has at least one vulnerability with high severity.
6.0.0-preview.1.21102.12 365,439 2/12/2021 6.0.0-preview.1.21102.12 is deprecated because it is no longer maintained; 6.0.0-preview.1.21102.12 has at least one vulnerability with high severity.
5.0.0 174,534,548 11/9/2020 5.0.0 is deprecated because it is no longer maintained.
5.0.0-rc.2.20475.5 380,526 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 323,961 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 202,001 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 117,117 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,799 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,378 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 202,020 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,933 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 111,804 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,142 3/16/2020 5.0.0-preview.1.20120.4 is deprecated because it is no longer maintained.
3.1.32 5,149,230 12/13/2022
3.1.31 994,027 11/8/2022
3.1.30 1,032,938 10/11/2022
3.1.29 1,315,786 9/13/2022
3.1.28 867,713 8/9/2022
3.1.27 906,608 7/12/2022
3.1.26 733,648 6/14/2022
3.1.25 1,181,323 5/10/2022
3.1.24 806,459 4/11/2022
3.1.23 1,529,842 3/8/2022
3.1.22 4,648,058 12/14/2021
3.1.21 3,459,410 11/7/2021
3.1.20 1,974,478 10/11/2021
3.1.19 2,649,046 9/14/2021
3.1.18 5,497,709 8/10/2021
3.1.17 2,329,430 7/13/2021
3.1.16 3,437,678 6/8/2021
3.1.15 3,516,890 5/11/2021
3.1.14 4,454,323 4/6/2021
3.1.13 5,460,057 3/9/2021
3.1.12 3,813,279 2/9/2021
3.1.11 6,436,796 1/12/2021
3.1.10 12,251,790 11/9/2020
3.1.9 16,670,244 10/13/2020
3.1.8 31,557,588 9/8/2020
3.1.7 16,309,884 8/11/2020
3.1.6 17,445,301 7/14/2020
3.1.5 17,483,692 6/9/2020
3.1.4 20,436,452 5/12/2020
3.1.3 31,301,354 3/24/2020
3.1.2 15,444,486 2/18/2020
3.1.1 24,352,733 1/14/2020
3.1.0 41,290,839 12/3/2019
3.1.0-preview3.19553.2 164,812 11/13/2019 3.1.0-preview3.19553.2 is deprecated because it is no longer maintained.
3.1.0-preview2.19525.4 32,191 11/1/2019 3.1.0-preview2.19525.4 is deprecated because it is no longer maintained.
3.1.0-preview1.19506.1 734,542 10/15/2019 3.1.0-preview1.19506.1 is deprecated because it is no longer maintained.
3.0.3 317,341 2/18/2020 3.0.3 is deprecated because it is no longer maintained.
3.0.2 95,255 1/14/2020 3.0.2 is deprecated because it is no longer maintained.
3.0.1 2,160,286 11/18/2019 3.0.1 is deprecated because it is no longer maintained.
3.0.0 37,070,386 9/23/2019 3.0.0 is deprecated because it is no longer maintained.
3.0.0-rc1.19456.10 46,646 9/16/2019 3.0.0-rc1.19456.10 is deprecated because it is no longer maintained.
3.0.0-preview9.19423.4 1,355,185 9/4/2019 3.0.0-preview9.19423.4 is deprecated because it is no longer maintained.
3.0.0-preview8.19405.4 406,331 8/13/2019 3.0.0-preview8.19405.4 is deprecated because it is no longer maintained.
3.0.0-preview7.19362.4 92,580 7/23/2019 3.0.0-preview7.19362.4 is deprecated because it is no longer maintained.
3.0.0-preview6.19304.6 177,424 6/12/2019 3.0.0-preview6.19304.6 is deprecated because it is no longer maintained.
3.0.0-preview5.19227.9 647,729 5/6/2019 3.0.0-preview5.19227.9 is deprecated because it is no longer maintained.
3.0.0-preview4.19216.2 22,844 4/18/2019 3.0.0-preview4.19216.2 is deprecated because it is no longer maintained.
3.0.0-preview3.19153.1 216,522 3/6/2019 3.0.0-preview3.19153.1 is deprecated because it is no longer maintained.
3.0.0-preview.19074.2 32,402 1/29/2019 3.0.0-preview.19074.2 is deprecated because it is no longer maintained.
3.0.0-preview.18572.1 52,748 12/3/2018 3.0.0-preview.18572.1 is deprecated because it is no longer maintained.
2.2.0 154,616,187 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 242,694 10/17/2018 2.2.0-preview3-35497 is deprecated because it is no longer maintained.
2.2.0-preview2-35157 172,927 9/12/2018 2.2.0-preview2-35157 is deprecated because it is no longer maintained.
2.2.0-preview1-35029 101,793 8/22/2018 2.2.0-preview1-35029 is deprecated because it is no longer maintained.
2.1.23 23,337,648 10/13/2020
2.1.2 33,041,214 8/21/2018
2.1.1 47,769,943 6/18/2018
2.1.0 67,578,735 5/29/2018
2.1.0-rc1-final 256,555 5/6/2018 2.1.0-rc1-final is deprecated because it is no longer maintained.
2.1.0-preview2-final 249,048 4/10/2018 2.1.0-preview2-final is deprecated because it is no longer maintained.
2.1.0-preview1-final 398,702 2/26/2018 2.1.0-preview1-final is deprecated because it is no longer maintained.
2.0.2 10,883,309 5/7/2018 2.0.2 is deprecated because it is no longer maintained.
2.0.1 17,108,865 3/13/2018 2.0.1 is deprecated because it is no longer maintained.
2.0.0 107,107,692 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 134,268 6/28/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 1,062,307 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.2 8,185,052 5/9/2017 1.1.2 is deprecated because it is no longer maintained.
1.1.1 17,074,578 3/6/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 9,277,762 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 70,340 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.2 4,204,020 3/6/2017 1.0.2 is deprecated because it is no longer maintained.
1.0.1 625,811 12/12/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 245,931,981 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 283,110 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.
1.0.0-rc1-final 510,650 11/18/2015 1.0.0-rc1-final is deprecated because it is no longer maintained.