CacheItem Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Caching

Zestaw:

System.Runtime.Caching.dll

Pakiet:

System.Runtime.Caching v9.0.0-rc.1.24431.7

Źródło:

CacheItem.cs

Reprezentuje pojedynczy wpis pamięci podręcznej w pamięci podręcznej.

public ref class CacheItem

public class CacheItem

type CacheItem = class

Public Class CacheItem

Dziedziczenie

Object

CacheItem

Przykłady

W poniższym przykładzie pokazano, jak używać CacheItem klasy do przechowywania zawartości pliku jako wpisu pamięci podręcznej.

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

Uwagi

Klasa CacheItem zapewnia logiczną reprezentację wpisu pamięci podręcznej, który może zawierać regiony przy użyciu RegionName właściwości . W domyślnej implementacji pamięci podręcznej ASP.NET wpis pamięci podręcznej jest parą klucz/wartość.

Wpisy w pamięci podręcznej nie CacheItem są wystąpieniami. Zamiast tego dostawca pamięci podręcznej może przechowywać wpisy pamięci podręcznej w dowolnym formacie wewnętrznym, który jest wygodny. Jednak interfejs API pamięci podręcznej wymaga, aby dostawcy pamięci podręcznej mogli konwertować wpisy pamięci podręcznej na CacheItem wystąpienia (i odwrotnie).

Implementacje niestandardowej pamięci podręcznej mogą dziedziczyć z CacheItem klasy, zapewniając dodatkowe informacje o wpisach pamięci podręcznej.

Uwagi dotyczące dziedziczenia

Klasa ObjectCache ma metody, które obsługują dodawanie, pobieranie i aktualizowanie danych pamięci podręcznej, a wszystkie te metody mają przeciążenia, które obsługują klasę CacheItem . W związku z tym niestandardowa implementacja pamięci podręcznej może utworzyć klasę rozszerzoną CacheItem i użyć tej rozszerzonej klasy wraz z istniejącym ObjectCache interfejsem API dla wpisów pamięci podręcznej.

Konstruktory

CacheItem(String)	Inicjuje nowe CacheItem wystąpienie przy użyciu określonego klucza wpisu pamięci podręcznej.
CacheItem(String, Object)	Inicjuje nowe CacheItem wystąpienie przy użyciu określonego klucza i wartości wpisu pamięci podręcznej.
CacheItem(String, Object, String)	Inicjuje nowe CacheItem wystąpienie przy użyciu określonego klucza, wartości i regionu wpisu pamięci podręcznej.

Właściwości

Key	Pobiera lub ustawia unikatowy identyfikator wystąpienia CacheItem .
RegionName	Pobiera lub ustawia nazwę regionu w pamięci podręcznej zawierającej CacheItem wpis.
Value	Pobiera lub ustawia dane dla CacheItem wystąpienia.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• ObjectCache