MemoryCache Sınıf

Tanım

Ad Alanı:

System.Runtime.Caching

Bütünleştirilmiş Kod:

System.Runtime.Caching.dll

Paket:

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

Kaynak:

MemoryCache.cs

Bellek içi önbellek uygulayan türü temsil eder.

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

Devralma

Object

ObjectCache

MemoryCache

Uygulamalar

IEnumerable IDisposable

Örnekler

Aşağıdaki örnek, varsayılan bellek önbelleği örneğine bir başvuru bildirir. Önbellek girdisi, önbellek girdisi için çıkarma ve süre sonu ayrıntıları sağlamak için bir CacheItemPolicy nesnesi kullanır. Ayrıca, dosya sistemindeki kaynak verilerin (bir dosyadır) durumunu izlemek için bir ChangeMonitor nesnesi kullanır.

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

Açıklamalar

MemoryCache sınıfı, soyut ObjectCache sınıfın somut bir uygulamasıdır.

Not

MemoryCache sınıfı, ASP.NET Cache sınıfına benzer. MemoryCache sınıfı, ASP.NET Cache sınıfını kullandıysanız önbelleğe erişmek için size tanıdık gelecek birçok özelliğe ve yönteme sahiptir. Cache ile MemoryCache sınıfları arasındaki temel farklar, MemoryCache sınıfının ASP.NET uygulamaları olmayan .NET Framework uygulamaları tarafından kullanılabilir hale getirilerek değiştirilmesidir. Örneğin, sınıfın MemoryCache derleme üzerinde System.Web hiçbir bağımlılığı yoktur. Bir diğer fark da aynı uygulamada ve aynı örnekte kullanmak üzere sınıfının birden çok örneğini MemoryCacheAppDomain oluşturabilmenizdir.

MemoryCache sınıfı önbellekte bir değer olarak izin null vermez. Değerine null sahip bir önbellek girdisi ekleme veya değiştirme girişimleri başarısız olur.

Türü MemoryCacheönbellek bölgelerini uygulamaz. Bu nedenle, bölgeler için parametre içeren temel yöntemleri uygulayan yöntemleri çağırdığınızda MemoryCache , parametresi için bir değer geçirmeyin. Bölge parametresini kullanan yöntemlerin tümü varsayılan null bir değer sağlar. Örneğin, yöntem aşırı yüklemesinde MemoryCache.AddOrGetExisting varsayılan değeri olan bir regionName parametre vardır null.

Oluşturucular

Name	Description
MemoryCache(String, NameValueCollection, Boolean)	MemoryCache sınıfının yeni bir örneğini başlatır.
MemoryCache(String, NameValueCollection)	MemoryCache sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
CacheMemoryLimit	Bilgisayardaki önbellek tarafından kullanılabilecek bellek miktarını bayt cinsinden alır.
Default	Varsayılan MemoryCache örneğe başvuru alır.
DefaultCacheCapabilities	Önbelleğin sağladığı özelliklerin açıklamasını alır.
Item[String]	Sınıfının bir örneği MemoryCache için varsayılan dizin oluşturucu özelliğini kullanarak önbellekteki bir değeri alır veya ayarlar.
Name	Önbelleğin adını alır.
PhysicalMemoryLimit	Önbelleğin girdileri çıkarma işlemini başlatacağı toplam sistem fiziksel bellek kullanımı yüzdesini alır.
PollingInterval	Önbelleğin bellek istatistiklerini güncelleştirdiği en uzun süreyi alır.

Yöntemler

Name	Description
Add(CacheItem, CacheItemPolicy)	Önbelleğe örnek olarak CacheItem bir önbellek girdisi ekler ve girdinin nasıl çıkarılacağıyla ilgili ayrıntıları ekler.
Add(String, Object, CacheItemPolicy, String)	Türetilmiş bir sınıfta geçersiz kılındığında, önbelleğe bir önbellek girdisi ekler ve girdinin nasıl çıkarılacağı hakkında bilgi belirtir. (Devralındığı yer: ObjectCache)
Add(String, Object, DateTimeOffset, String)	Türetilmiş bir sınıfta geçersiz kılındığında, var olan önbellek girdilerinin üzerine yazmadan önbelleğe bir önbellek girdisi ekler. (Devralındığı yer: ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Belirtilen CacheItem örneği kullanarak önbelleğe bir önbellek girdisi ekler ve girdinin nasıl çıkarılıp çıkarılamlarıyla ilgili ayrıntılar.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Belirtilen anahtarı ve değeri ve nasıl çıkarılacağına ilişkin belirtilen ayrıntıları kullanarak önbelleğe bir önbellek girdisi ekler.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Belirtilen anahtarı ve bir değeri ve mutlak süre sonu değerini kullanarak önbelleğe bir önbellek girdisi ekler.
Contains(String, String)	Önbellekte önbellek girdisi olup olmadığını belirler.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	Belirtilen önbellek girişlerindeki değişikliklere yanıt olarak olayları tetikleyebilen bir CacheEntryChangeMonitor nesne oluşturur.
Dispose()	Sınıfın geçerli örneği MemoryCache tarafından kullanılan tüm kaynakları serbest bırakır.
Get(String, String)	Önbellekten bir girdi döndürür.
GetCacheItem(String, String)	Önbellekten belirtilen girdiyi örnek CacheItem olarak döndürür.
GetCount(String)	Önbellekteki toplam önbellek girdisi sayısını döndürür.
GetEnumerator()	Önbellek girdileri koleksiyonu aracılığıyla yinelemek için kullanılabilecek bir numaralandırıcı oluşturur.
GetLastSize(String)	Adlandırılmış bölgenin boyutunu alır.
GetValues(IEnumerable<String>, String)	Belirtilen anahtarlara karşılık gelen bir dizi önbellek girdisi döndürür.
GetValues(String, String[])	Belirtilen anahtarlara karşılık gelen bir dizi önbellek girdisi alır. (Devralındığı yer: ObjectCache)
Remove(String, CacheEntryRemovedReason, String)	Nedeni kullanarak önbellekten bir önbellek girdisini kaldırır.
Remove(String, String)	Önbellekten önbellek girdisini kaldırır.
Set(CacheItem, CacheItemPolicy)	Önbellek girdisinin anahtarını ve değerini sağlamak için bir CacheItem örnek kullanarak önbelleğe bir önbellek girdisi ekler.
Set(String, Object, CacheItemPolicy, String)	Bir anahtar, bir değer ve çıkarma kullanarak önbelleğe bir önbellek girdisi ekler.
Set(String, Object, DateTimeOffset, String)	Bir anahtar ve değer kullanarak önbelleğe önbellek girdisi ekler ve zamana bağlı süre sonu ayrıntılarını belirtir.
Trim(Int32)	Önbellek nesnesinden belirtilen önbellek girdisi yüzdesini kaldırır.

Belirtik Arabirim Kullanımları

Name	Description
IEnumerable.GetEnumerator()	Genel bir koleksiyon üzerinde yineleme desteği sağlar.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Kesin olarak türü belirlenmiş bir koleksiyon üzerinde yinelemeyi destekler. (Devralındığı yer: ObjectCache)

Uzantı Metotları

Name	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	aracılığıyla IAsyncEnumerable<T>yineleyen yeni source bir oluşturur.
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Belirtilen anahtar seçici ve öğe seçici işlevlerine göre öğesinden bir FrozenDictionary<TKey,TValue>IEnumerable<T> oluşturur.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Belirtilen anahtar seçici işlevine göre işlevinden bir FrozenDictionary<TKey,TValue>IEnumerable<T> oluşturur.
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Belirtilen değerlerle bir FrozenSet<T> oluşturur.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Belirtilen koleksiyondan sabit bir dizi oluşturur.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar ve değer karşılaştırıcılarını kullanarak içeriğinin sabit bir sözlüğü oluşturur.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar karşılaştırıcıyı kullanarak içeriğinin sabit bir sözlüğü oluşturur.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Bir diziyi numaralandırır ve dönüştürür ve içeriğinin sabit bir sözlüğü oluşturur.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Bir dizideki bazı dönüştürmeleri temel alan sabit bir sözlük oluşturur.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Var olan bir öğe koleksiyonundan sabit bir sözlük oluşturur ve kaynak anahtarlara bir dönüştürme işlevi uygular.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Bir diziyi numaralandırır, içeriğini sabit bir karma kümesi oluşturur ve küme türü için belirtilen eşitlik karşılaştırıcısını kullanır.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Bir diziyi numaralandırır ve içeriğinin sabit bir karma kümesini oluşturur.
ToImmutableList<TSource>(IEnumerable<TSource>)	Bir diziyi numaralandırır ve içeriğinin sabit bir listesini oluşturur.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar ve değer karşılaştırıcılarını kullanarak içeriğinin sabit bir sıralanmış sözlüğü oluşturur.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar karşılaştırıcıyı kullanarak içeriğinin sabit bir sıralanmış sözlüğü oluşturur.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Bir diziyi numaralandırır ve dönüştürür ve içeriğinin sabit sıralanabilir bir sözlüğü oluşturur.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Bir diziyi numaralandırır, içeriğinin sabit bir sıralanmış kümesini oluşturur ve belirtilen karşılaştırıcıyı kullanır.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Bir diziyi numaralandırır ve içindekilerin sabit sıralanabilir bir kümesini oluşturur.

İş Parçacığı Güvenliği

Bu tür iş parçacığı güvenlidir.

Ayrıca bkz.

• ObjectCache
• .NET Framework Uygulamalarında Caching