MemoryCache Classe

Definizione

Spazio dei nomi:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacchetto:

System.Runtime.Caching v8.0.0

Source:

MemoryCache.cs

Rappresenta il tipo che implementa una cache in memoria.

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

Ereditarietà

Object

ObjectCache

MemoryCache

Implementazioni

IEnumerable IDisposable

Esempio

Nell'esempio seguente viene dichiarato un riferimento all'istanza predefinita della cache di memoria. La voce della cache usa un CacheItemPolicy oggetto per fornire dettagli di rimozione e scadenza per la voce della cache. Usa anche un ChangeMonitor oggetto per monitorare lo stato dei dati di origine (ovvero un file) nel file system.

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

Commenti

La classe MemoryCache è un'implementazione concreta della classe astratta ObjectCache .

Nota

La MemoryCache classe è simile alla classe ASP.NET Cache . La MemoryCache classe ha molte proprietà e metodi per accedere alla cache che sarà familiare se è stata usata la classe ASP.NET Cache . Le differenze principali tra le Cache classi e MemoryCache sono che la MemoryCache classe è stata modificata per renderla utilizzabile dalle applicazioni .NET Framework che non sono ASP.NET applicazioni. Ad esempio, la MemoryCache classe non ha dipendenze dall'assembly System.Web . Un'altra differenza è che è possibile creare più istanze della MemoryCache classe da usare nella stessa applicazione e nella stessa AppDomain istanza.

La MemoryCache classe non consente null come valore nella cache. Qualsiasi tentativo di aggiungere o modificare una voce della cache con un valore di null avrà esito negativo.

Il MemoryCache tipo non implementa le aree della cache. Pertanto, quando si chiamano MemoryCache metodi che implementano metodi di base che contengono un parametro per le aree, non passano un valore per il parametro. I metodi che usano il parametro area forniscono tutti un valore predefinito null . Ad esempio, l'overload del MemoryCache.AddOrGetExisting metodo ha un regionName parametro il cui valore predefinito è null.

Costruttori

MemoryCache(String, NameValueCollection)	Inizializza una nuova istanza della classe MemoryCache.
MemoryCache(String, NameValueCollection, Boolean)	Inizializza una nuova istanza della classe MemoryCache.

Proprietà

CacheMemoryLimit	Ottiene la quantità di memoria nel computer, in byte, che può essere usata dalla cache.
Default	Ottiene un riferimento all'istanza di MemoryCache predefinita.
DefaultCacheCapabilities	Ottiene una descrizione delle funzionalità disponibili nella cache.
Item[String]	Ottiene o imposta un valore nella cache usando la proprietà dell'indicizzatore predefinita per un'istanza della classe MemoryCache.
Name	Ottiene il nome della cache.
PhysicalMemoryLimit	Ottiene la percentuale di memoria fisica che la cache può usare.
PollingInterval	Ottiene il periodo massimo di tempo dopo il quale la cache aggiorna le statistiche relative alla memoria.

Metodi

Add(CacheItem, CacheItemPolicy)	Inserisce una voce della cache nella cache come istanza di CacheItem e aggiunge i dettagli sulla modalità di eliminazione della voce.
Add(String, Object, CacheItemPolicy, String)	Se sottoposto a override in una classe derivata, inserisce una voce della cache nella cache specificando le informazioni sulla modalità di eliminazione della voce. (Ereditato da ObjectCache)
Add(String, Object, DateTimeOffset, String)	Se sottoposto a override in una classe derivata, inserisce una voce della cache nella cache senza sovrascrivere alcuna voce della cache esistente. (Ereditato da ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Aggiunge una voce della cache nella cache usando l'istanza di CacheItem specificata e i dettagli sulla modalità di eliminazione della voce.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Inserisce una voce della cache nella cache usando la chiave e il valore specificati e i dettagli sulla modalità di eliminazione della voce specificati.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Aggiunge una voce della cache nella cache usando la chiave e il valore specificati e un valore di scadenza assoluto.
Contains(String, String)	Determina se una voce della cache esiste nella cache.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	Crea un oggetto CacheEntryChangeMonitor in grado di attivare eventi in risposta alle modifiche alle voci della cache specificate.
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della classe MemoryCache.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Get(String, String)	Restituisce una voce dalla cache.
GetCacheItem(String, String)	Restituisce la voce specificata dalla cache come istanza di CacheItem.
GetCount(String)	Restituisce il numero totale di voci della cache nella cache.
GetEnumerator()	Crea un enumeratore che può essere usato per scorrere una raccolta di voci della cache.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLastSize(String)	Ottiene le dimensioni dell'area denominata.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValues(IEnumerable<String>, String)	Restituisce un set di voci della cache corrispondenti alle chiavi specificate.
GetValues(String, String[])	Ottiene un set di voci della cache corrispondenti alle chiavi specificate. (Ereditato da ObjectCache)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(String, CacheEntryRemovedReason, String)	Rimuove una voce dalla cache specificando il motivo.
Remove(String, String)	Rimuove una voce della cache dalla cache.
Set(CacheItem, CacheItemPolicy)	Inserisce una voce della cache nella cache usando un'istanza di CacheItem per specificare la chiave e il valore per la voce della cache.
Set(String, Object, CacheItemPolicy, String)	Inserisce una voce della cache nella cache usando una chiave, un valore e l'eliminazione.
Set(String, Object, DateTimeOffset, String)	Inserisce una voce della cache nella cache usando una chiave e un valore e specifica i dettagli della scadenza basati sull'ora.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Trim(Int32)	Rimuove una percentuale di voci della cache specificata dall'oggetto cache.

Implementazioni dell'interfaccia esplicita

IEnumerable.GetEnumerator()	Fornisce supporto per l'iterazione in una raccolta generica.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Supporta l'iterazione su una raccolta fortemente tipizzata. (Ereditato da ObjectCache)

Metodi di estensione

Thread safety

Questo tipo è thread-safe.

Vedi anche

• ObjectCache
• Procedura dettagliata: Memorizzazione nella cache dei dati applicazioni in ASP.NET
• Memorizzazione nella cache in applicazioni .NET Framework