MemoryCache Kelas

Definisi

Ruang nama:

System.Runtime.Caching

Rakitan:

System.Runtime.Caching.dll

Paket:

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

Sumber:

MemoryCache.cs

Mewakili jenis yang mengimplementasikan cache dalam memori.

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

Warisan

Object

ObjectCache

MemoryCache

Penerapan

IEnumerable IDisposable

Contoh

Contoh berikut mendeklarasikan referensi ke instans cache memori default. Entri cache menggunakan CacheItemPolicy objek untuk memberikan detail pengeluaran dan kedaluwarsa untuk entri cache. Ini juga menggunakan ChangeMonitor objek untuk memantau status data sumber (yang merupakan file) pada sistem file.

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;
}

Keterangan

Kelas MemoryCache ini adalah implementasi konkret dari kelas abstrak ObjectCache .

Nota

Kelas mirip dengan kelas /> ASP.NET MemoryCache memiliki banyak properti dan metode untuk mengakses cache yang akan akrab bagi Anda jika Anda telah menggunakan kelas ASP.NET Cache. Perbedaan utama antara kelas Cache dan MemoryCache adalah bahwa kelas MemoryCache telah diubah untuk membuatnya dapat digunakan oleh aplikasi .NET Framework yang tidak ASP.NET aplikasi. Misalnya, MemoryCache kelas tidak memiliki dependensi pada perakitan System.Web . Perbedaan lain adalah Anda dapat membuat beberapa instans kelas untuk digunakan dalam aplikasi yang sama dan dalam instans MemoryCache yang sama AppDomain .

Kelas MemoryCache tidak mengizinkan null sebagai nilai dalam cache. Setiap upaya untuk menambahkan atau mengubah entri cache dengan nilai null akan gagal.

MemoryCache Jenis tidak menerapkan wilayah cache. Oleh karena itu, ketika Anda memanggil MemoryCache metode yang menerapkan metode dasar yang berisi parameter untuk wilayah, jangan meneruskan nilai untuk parameter . Metode yang menggunakan parameter wilayah semuanya menyediakan nilai default null . Misalnya, MemoryCache.AddOrGetExisting metode kelebihan beban memiliki regionName parameter yang nilai defaultnya adalah null.

Konstruktor

Nama	Deskripsi
MemoryCache(String, NameValueCollection, Boolean)	Menginisialisasi instans baru dari kelas MemoryCache.
MemoryCache(String, NameValueCollection)	Menginisialisasi instans baru dari kelas MemoryCache.

Properti

Nama	Deskripsi
CacheMemoryLimit	Mendapatkan jumlah memori di komputer, dalam byte, yang dapat digunakan oleh cache.
Default	Mendapatkan referensi ke instans default MemoryCache .
DefaultCacheCapabilities	Mendapatkan deskripsi fitur yang disediakan cache.
Item[String]	Mendapatkan atau menetapkan nilai dalam cache dengan menggunakan properti pengindeks default untuk instans MemoryCache kelas.
Name	Mendapatkan nama cache.
PhysicalMemoryLimit	Mendapatkan persentase total penggunaan memori fisik sistem di mana cache akan mulai mengeluarkan entri.
PollingInterval	Mendapatkan waktu maksimum setelah cache memperbarui statistik memorinya.

Metode

Nama	Deskripsi
Add(CacheItem, CacheItemPolicy)	Menyisipkan entri cache ke dalam cache sebagai CacheItem instans, dan menambahkan detail tentang bagaimana entri harus dikeluarkan.
Add(String, Object, CacheItemPolicy, String)	Ketika ditimpa di kelas turunan, menyisipkan entri cache ke dalam cache, menentukan informasi tentang bagaimana entri akan dikeluarkan. (Diperoleh dari ObjectCache)
Add(String, Object, DateTimeOffset, String)	Ketika ditimpa di kelas turunan, menyisipkan entri cache ke dalam cache tanpa menimpa entri cache yang ada. (Diperoleh dari ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Menambahkan entri cache ke dalam cache menggunakan instans yang ditentukan CacheItem dan detail tentang cara mengeluarkan entri.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Menyisipkan entri cache ke dalam cache menggunakan kunci dan nilai yang ditentukan dan detail yang ditentukan tentang bagaimana entri tersebut dikeluarkan.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Menambahkan entri cache ke dalam cache menggunakan kunci yang ditentukan dan nilai serta nilai kedaluwarsa absolut.
Contains(String, String)	Menentukan apakah entri cache ada di cache.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	CacheEntryChangeMonitor Membuat objek yang dapat memicu peristiwa sebagai respons terhadap perubahan pada entri cache yang ditentukan.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans MemoryCache kelas saat ini.
Get(String, String)	Mengembalikan entri dari cache.
GetCacheItem(String, String)	Mengembalikan entri yang ditentukan dari cache sebagai CacheItem instans.
GetCount(String)	Mengembalikan jumlah total entri cache dalam cache.
GetEnumerator()	Membuat enumerator yang dapat digunakan untuk melakukan iterasi melalui kumpulan entri cache.
GetLastSize(String)	Mendapatkan ukuran wilayah bernama.
GetValues(IEnumerable<String>, String)	Mengembalikan sekumpulan entri cache yang sesuai dengan kunci yang ditentukan.
GetValues(String, String[])	Mendapatkan sekumpulan entri cache yang sesuai dengan kunci yang ditentukan. (Diperoleh dari ObjectCache)
Remove(String, CacheEntryRemovedReason, String)	Menghapus entri cache dari cache menggunakan alasannya.
Remove(String, String)	Menghapus entri cache dari cache.
Set(CacheItem, CacheItemPolicy)	Menyisipkan entri cache ke dalam cache dengan menggunakan CacheItem instans untuk menyediakan kunci dan nilai untuk entri cache.
Set(String, Object, CacheItemPolicy, String)	Menyisipkan entri cache ke dalam cache dengan menggunakan kunci dan nilai dan pengeluaran.
Set(String, Object, DateTimeOffset, String)	Menyisipkan entri cache ke dalam cache dengan menggunakan kunci dan nilai dan menentukan detail kedaluwarsa berbasis waktu.
Trim(Int32)	Menghapus persentase entri cache tertentu dari objek cache.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IEnumerable.GetEnumerator()	Menyediakan dukungan untuk perulangan melalui koleksi generik.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Mendukung iterasi melalui koleksi yang ditik dengan kuat. (Diperoleh dari ObjectCache)

Metode Ekstensi

Nama	Deskripsi
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	Membuat baru IAsyncEnumerable<T> yang berulang melalui source.
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Membuat FrozenDictionary<TKey,TValue> dari IEnumerable<T> sesuai dengan fungsi pemilih kunci dan pemilih elemen yang ditentukan.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	FrozenDictionary<TKey,TValue> Membuat dari sesuai dengan fungsi pemilih kunci yang IEnumerable<T> ditentukan.
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	FrozenSet<T> Membuat dengan nilai yang ditentukan.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Membuat array yang tidak dapat diubah dari koleksi yang ditentukan.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Menghitung dan mengubah urutan, dan menghasilkan kamus kontennya yang tidak dapat diubah dengan menggunakan pembanding kunci dan nilai yang ditentukan.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Menghitung dan mengubah urutan, dan menghasilkan kamus kontennya yang tidak dapat diubah dengan menggunakan pembanding kunci yang ditentukan.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Menghitung dan mengubah urutan, dan menghasilkan kamus kontennya yang tidak dapat diubah.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Membangun kamus yang tidak dapat diubah berdasarkan beberapa transformasi urutan.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Membangun kamus yang tidak dapat diubah dari kumpulan elemen yang ada, menerapkan fungsi transformasi ke kunci sumber.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Menghitung urutan, menghasilkan set hash yang tidak dapat diubah dari kontennya, dan menggunakan perbandingan kesetaraan yang ditentukan untuk jenis yang ditetapkan.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Menghitung urutan dan menghasilkan kumpulan hash kontennya yang tidak dapat diubah.
ToImmutableList<TSource>(IEnumerable<TSource>)	Menghitung urutan dan menghasilkan daftar kontennya yang tidak dapat diubah.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Menghitung dan mengubah urutan, dan menghasilkan kamus yang diurutkan yang tidak dapat diubah dari kontennya dengan menggunakan pembanding kunci dan nilai yang ditentukan.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Menghitung dan mengubah urutan, dan menghasilkan kamus yang diurutkan yang tidak dapat diubah dari kontennya dengan menggunakan pembanding kunci yang ditentukan.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Menghitung dan mengubah urutan, dan menghasilkan kamus kontennya yang diurutkan tidak dapat diubah.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Menghitung urutan, menghasilkan kumpulan kontennya yang diurutkan yang tidak dapat diubah, dan menggunakan pembanding yang ditentukan.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Menghitung urutan dan menghasilkan sekumpulan kontennya yang diurutkan yang tidak dapat diubah.

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• ObjectCache
• Caching di .NET Framework Applications