MemoryCache Класс

Определение

Пространство имен:

System.Runtime.Caching

Сборка:

System.Runtime.Caching.dll

Пакет:

System.Runtime.Caching v11.0.0-preview.3.26207.106

Исходный код:

MemoryCache.cs

Представляет тип, реализующий кэш в памяти.

public ref class MemoryCache : System::Runtime::Caching::ObjectCache, IDisposable

public class MemoryCache : System.Runtime.Caching.ObjectCache, IDisposable

type MemoryCache = class
    inherit ObjectCache
    interface IEnumerable
    interface IDisposable

Public Class MemoryCache
Inherits ObjectCache
Implements IDisposable

Наследование

Object

ObjectCache

MemoryCache

Реализации

IEnumerable IDisposable

Примеры

В следующем примере объявляется ссылка на экземпляр кэша памяти по умолчанию. Запись кэша использует объект для предоставления сведений CacheItemPolicy о вытеснениях и истечении срока действия записи кэша. Он также использует ChangeMonitor объект для мониторинга состояния исходных данных (который является файлом) в файловой системе.

Private Sub btnGet_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim cache As ObjectCache = MemoryCache.[Default]
    Dim fileContents As String = TryCast(cache("filecontents"), String)

    If fileContents Is Nothing Then
        Dim policy As New CacheItemPolicy()
        Dim filePaths As New List(Of String)()
        filePaths.Add("c:\cache\example.txt")

        policy.ChangeMonitors.Add(New HostFileChangeMonitor(filePaths))

        ' Fetch the file contents.
        fileContents = File.ReadAllText("c:\cache\example.txt")

        cache.[Set]("filecontents", fileContents, policy)
    End If

    Label1.Text = fileContents
End Sub

private void btnGet_Click(object sender, EventArgs e)
{
    ObjectCache cache = MemoryCache.Default;
    string fileContents = cache["filecontents"] as string;

    if (fileContents == null)
    {
        CacheItemPolicy policy = new CacheItemPolicy();

        List<string> filePaths = new List<string>();
        filePaths.Add("c:\\cache\\example.txt");

        policy.ChangeMonitors.Add(new
        HostFileChangeMonitor(filePaths));

        // Fetch the file contents.
        fileContents =
            File.ReadAllText("c:\\cache\\example.txt");

        cache.Set("filecontents", fileContents, policy);
    }

    Label1.Text = fileContents;
}

Комментарии

Класс MemoryCache представляет собой конкретную реализацию абстрактного ObjectCache класса.

Заметка

Класс MemoryCache аналогичен классу ASP.NET Cache. Класс MemoryCache имеет множество свойств и методов для доступа к кэшу, который будет знаком с вами, если вы использовали класс ASP.NET Cache. Основные различия между классами Cache и MemoryCache заключается в том, что класс MemoryCache был изменен, чтобы сделать его пригодным для приложений .NET Framework, которые не являются ASP.NET приложениями. Например, MemoryCache класс не имеет зависимостей от сборки System.Web . Другое отличие заключается в том, что можно создать несколько экземпляров MemoryCache класса для использования в одном приложении и в одном AppDomain экземпляре.

Класс MemoryCache не допускает null как значение в кэше. Любая попытка добавить или изменить запись кэша со значением null завершится ошибкой.

Тип MemoryCache не реализует регионы кэша. Поэтому при вызове MemoryCache методов, реализующих базовые методы, содержащие параметр для регионов, не передают значение для параметра. Методы, использующие параметр региона, предоставляют значение по умолчанию null . Например, перегрузка MemoryCache.AddOrGetExisting метода имеет regionName параметр, значение по умолчанию которого равно null.

Конструкторы

Имя	Описание
MemoryCache(String, NameValueCollection, Boolean)	Инициализирует новый экземпляр класса MemoryCache.
MemoryCache(String, NameValueCollection)	Инициализирует новый экземпляр класса MemoryCache.

Свойства

Имя	Описание
CacheMemoryLimit	Получает объем памяти на компьютере в байтах, который может использоваться кэшем.
Default	Возвращает ссылку на экземпляр по умолчанию MemoryCache .
DefaultCacheCapabilities	Возвращает описание функций, предоставляемых кэшем.
Item[String]	Возвращает или задает значение в кэше с помощью свойства индексатора по умолчанию для экземпляра MemoryCache класса.
Name	Возвращает имя кэша.
PhysicalMemoryLimit	Возвращает процент общего использования физической памяти системы, с которого кэш начнет вытеснение записей.
PollingInterval	Получает максимальное время, после которого кэш обновляет статистику памяти.

Методы

Имя	Описание
Add(CacheItem, CacheItemPolicy)	Вставляет запись кэша в кэш в качестве экземпляра CacheItem и добавляет сведения о том, как следует вытеснить запись.
Add(String, Object, CacheItemPolicy, String)	При переопределении в производном классе вставляет запись кэша в кэш, указывая сведения о том, как запись будет вытеснена. (Унаследовано от ObjectCache)
Add(String, Object, DateTimeOffset, String)	При переопределении в производном классе вставляет запись кэша в кэш без перезаписи существующей записи кэша. (Унаследовано от ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Добавляет запись кэша в кэш с помощью указанного CacheItem экземпляра и сведения о том, как вытеснить запись.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Вставляет запись кэша в кэш, используя указанный ключ и значение, а также указанные сведения о том, как он должен быть вытеснен.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Добавляет запись кэша в кэш с помощью указанного ключа и значения и абсолютного истечения срока действия.
Contains(String, String)	Определяет, существует ли запись кэша в кэше.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	CacheEntryChangeMonitor Создает объект, который может активировать события в ответ на изменения указанных записей кэша.
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром MemoryCache класса.
Get(String, String)	Возвращает запись из кэша.
GetCacheItem(String, String)	Возвращает указанную запись из кэша в качестве экземпляра CacheItem .
GetCount(String)	Возвращает общее количество записей кэша в кэше.
GetEnumerator()	Создает перечислитель, который можно использовать для итерации с помощью коллекции записей кэша.
GetLastSize(String)	Возвращает размер именованного региона.
GetValues(IEnumerable<String>, String)	Возвращает набор записей кэша, соответствующих указанным ключам.
GetValues(String, String[])	Возвращает набор записей кэша, соответствующих указанным ключам. (Унаследовано от ObjectCache)
Remove(String, CacheEntryRemovedReason, String)	Удаляет запись кэша из кэша с помощью причины.
Remove(String, String)	Удаляет запись кэша из кэша.
Set(CacheItem, CacheItemPolicy)	Вставляет запись кэша в кэш с помощью экземпляра CacheItem , чтобы указать ключ и значение для записи кэша.
Set(String, Object, CacheItemPolicy, String)	Вставляет запись кэша в кэш с помощью ключа и значения и вытеснения.
Set(String, Object, DateTimeOffset, String)	Вставляет запись кэша в кэш с помощью ключа и значения и задает сведения о истечении срока действия на основе времени.
Trim(Int32)	Удаляет указанный процент записей кэша из объекта кэша.

Явные реализации интерфейса

Имя	Описание
IEnumerable.GetEnumerator()	Предоставляет поддержку итерации по универсальной коллекции.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Поддерживает итерацию по строго типизированной коллекции. (Унаследовано от ObjectCache)

Методы расширения

Имя	Описание
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	Создает новое IAsyncEnumerable<T> , которое выполняет итерацию source.
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Создает FrozenDictionary<TKey,TValue> из IEnumerable<T> в соответствии с указанными функциями селектора ключей и селектора элементов.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Создает из FrozenDictionary<TKey,TValue> указанной функции селектора ключей IEnumerable<T> .
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Создает объект FrozenSet<T> с указанными значениями.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Создает неизменяемый массив из указанной коллекции.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Перечисляет и преобразует последовательность и создает неизменяемый словарь его содержимого с помощью указанных средств сравнения ключей и значений.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Перечисляет и преобразует последовательность и создает неизменяемый словарь его содержимого с помощью указанного средства сравнения ключей.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Перечисляет и преобразует последовательность и создает неизменяемый словарь его содержимого.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Создает неизменяемый словарь на основе некоторого преобразования последовательности.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Создает неизменяемый словарь из существующей коллекции элементов, применяя функцию преобразования к исходным ключам.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Перечисляет последовательность, создает неизменяемый хэш-набор его содержимого и использует указанный средство сравнения равенства для типа набора.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Перечисляет последовательность и создает неизменяемый хэш-набор его содержимого.
ToImmutableList<TSource>(IEnumerable<TSource>)	Перечисляет последовательность и создает неизменяемый список его содержимого.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Перечисляет и преобразует последовательность и создает неизменяемый отсортированный словарь его содержимого с помощью указанных средств сравнения ключей и значений.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Перечисляет и преобразует последовательность и создает неизменяемый отсортированный словарь его содержимого с помощью указанного средства сравнения ключей.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Перечисляет и преобразует последовательность и создает неизменяемый отсортированный словарь его содержимого.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Перечисляет последовательность, создает неизменяемый отсортированный набор его содержимого и использует указанный сопоставитель.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Перечисляет последовательность и создает неизменяемый отсортированный набор его содержимого.

Потокобезопасность

Этот тип является потокобезопасной.

См. также раздел

• ObjectCache
• Caching в приложениях .NET Framework