CacheItem Classe

Definizione

Spazio dei nomi:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacchetto:

System.Runtime.Caching v8.0.0

Origine:

CacheItem.cs

Rappresenta una singola voce della cache nella cache.

public ref class CacheItem

public class CacheItem

type CacheItem = class

Public Class CacheItem

Ereditarietà

Object

CacheItem

Esempio

Nell'esempio seguente viene illustrato come usare la CacheItem classe per archiviare il contenuto di un file come voce della cache.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Runtime.Caching;
using System.IO;

public partial class _Default : System.Web.UI.Page
{

    protected void Button1_Click(object sender, EventArgs e)
    {
        ObjectCache cache = MemoryCache.Default;

        CacheItem fileContents = cache.GetCacheItem("filecontents");

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

            List<string> filePaths = new List<string>();
            string cachedFilePath = Server.MapPath("~") +
                "\\cacheText.txt";

            filePaths.Add(cachedFilePath);

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

            // Fetch the file contents
            string fileData = File.ReadAllText(cachedFilePath);

            fileContents = new CacheItem("filecontents", fileData);

            cache.Set(fileContents, policy);
        }
        Label1.Text = (fileContents.Value as string);
    }
}

Imports System.Runtime.Caching
Imports System.IO

Partial Class _Default
    Inherits System.Web.UI.Page

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button1.Click

        Dim cache As ObjectCache = MemoryCache.Default

        Dim fileContents As CacheItem = cache.GetCacheItem("filecontents")

        If fileContents Is Nothing Then
            Dim policy As New CacheItemPolicy()

            Dim filePaths As New List(Of String)()

            Dim CachedFilePaths As String = Server.MapPath("~") & "\cacheText.txt"

                filePaths.Add(CachedFilePaths)

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

            ' Fetch the file contents 
            Dim fileData As String = File.ReadAllText(CachedFilePaths)

            fileContents = New CacheItem("filecontents", fileData)

            cache.Set(fileContents, policy)
        End If
        Label1.Text = TryCast(fileContents.Value, String)
    End Sub
End Class

Commenti

La CacheItem classe fornisce una rappresentazione logica di una voce della cache, che può includere aree usando la RegionName proprietà . Nell'implementazione predefinita della cache ASP.NET una voce della cache è una coppia chiave/valore.

Le voci nella cache non CacheItem sono istanze di . Al contrario, il provider di cache può archiviare le voci della cache in qualsiasi formato interno conveniente. Tuttavia, l'API cache richiede che i provider di cache siano in grado di convertire le voci della cache in CacheItem istanze (e viceversa).

Le implementazioni della cache personalizzate possono ereditare dalla CacheItem classe forniscono informazioni aggiuntive sulle voci della cache.

Note per gli eredi

La ObjectCache classe include metodi che supportano l'aggiunta, il recupero e l'aggiornamento dei dati della cache e tutti questi metodi hanno overload che supportano la CacheItem classe . Pertanto, un'implementazione della cache personalizzata può creare una classe estesa CacheItem e usarla insieme all'API esistente ObjectCache per le voci della cache.

Costruttori

CacheItem(String)	Inizializza una nuova istanza di CacheItem utilizzando la chiave specificata di una voce della cache.
CacheItem(String, Object)	Inizializza una nuova istanza di CacheItem utilizzando la chiave specificata e un valore della voce della cache.
CacheItem(String, Object, String)	Inizializza una nuova istanza di CacheItem utilizzando la chiave, il valore e l'area specificati della voce della cache.

Proprietà

Key	Ottiene o imposta un identificatore univoco per un'istanza di CacheItem.
RegionName	Ottiene o imposta il nome di un'area nella cache che contiene una voce CacheItem.
Value	Ottiene o imposta i dati per un'istanza di CacheItem.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• ObjectCache