CacheItem Klasse

Definition

Stellt einen individuellen Cacheeintrag im Cache dar.Represents an individual cache entry in the cache.

public ref class CacheItem
public class CacheItem
type CacheItem = class
Public Class CacheItem
Vererbung
CacheItem

Beispiele

Im folgenden Beispiel wird gezeigt, wie die CacheItem -Klasse verwendet wird, um den Inhalt einer Datei als Cache Eintrag zu speichern.The following example shows how to use the CacheItem class to store the contents of a file as a cache entry.

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

Hinweise

Die CacheItem -Klasse stellt eine logische Darstellung eines Cache Eintrags bereit, der Regionen mithilfe der RegionName -Eigenschaft enthalten kann.The CacheItem class provides a logical representation of a cache entry, which can include regions by using the RegionName property. In der standardmäßigen ASP.NET-Cache Implementierung ist ein Cache Eintrag ein Schlüssel-Wert-Paar.In the default ASP.NET cache implementation, a cache entry is a key/value pair.

Einträge im Cache sind keine CacheItem Instanzen.Entries in the cache are not CacheItem instances. Stattdessen kann der Cache Anbieter Cache Einträge in einem beliebigen internen Format speichern.Instead, the cache provider can store cache entries in any internal format that is convenient. Die Cache-API erfordert jedoch, dass Cache Anbieter Cache Einträge in CacheItem Instanzen konvertieren können (und umgekehrt).However, the cache API requires cache providers to be able to convert cache entries into CacheItem instances (and vice versa).

Benutzerdefinierte Cache Implementierungen können von der CacheItem -Klasse erben, um zusätzliche Informationen zu Cache Einträgen bereitzustellen.Custom cache implementations can inherit from the CacheItem class provide additional information about cache entries.

Hinweise für Vererber

Die ObjectCache -Klasse verfügt über Methoden, die das Hinzufügen, abrufen und Aktualisieren von Cache Daten unterstützen, und alle diese Methoden verfügen CacheItem über über Ladungen, die die-Klasse unterstützen.The ObjectCache class has methods that support adding, fetching, and updating cache data, and all these methods have overloads that support the CacheItem class. Daher kann eine benutzerdefinierte Cache Implementierung eine erweiterte CacheItem Klasse erstellen und diese erweiterte Klasse in Verbindung mit der vorhandenen ObjectCache API für Cache Einträge verwenden.Therefore, a custom cache implementation can create an extended CacheItem class and use that extended class together with the existing ObjectCache API for cache entries.

Konstruktoren

CacheItem(String)

Initialisiert eine neue CacheItem-Instanz unter Verwendung des angegebenen Schlüssels eines Cacheeintrags.Initializes a new CacheItem instance using the specified key of a cache entry.

CacheItem(String, Object)

Initialisiert eine neue CacheItem-Instanz unter Verwendung des angegebenen Schlüssels und Werts des Cacheeintrags.Initializes a new CacheItem instance using the specified key and a value of the cache entry.

CacheItem(String, Object, String)

Initialisiert eine neue CacheItem-Instanz unter Verwendung des angegebenen Schlüssels, Werts und Bereichs des Cacheeintrags.Initializes a new CacheItem instance using the specified key, value, and region of the cache entry.

Eigenschaften

Key

Ruft einen eindeutigen Bezeichner für eine CacheItem-Instanz ab oder legt ihn fest.Gets or sets a unique identifier for a CacheItem instance.

RegionName

Ruft den Namen eines Bereichs im Cache ab, der einen CacheItem-Eintrag enthält, oder legt diesen fest.Gets or sets the name of a region in the cache that contains a CacheItem entry.

Value

Ruft die Daten für eine CacheItem-Instanz ab oder legt diese fest.Gets or sets the data for a CacheItem instance.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch