Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Cache.Insert-Methode: (String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

 

Veröffentlicht: Oktober 2016

Fügt ein Objekt in der Cache -Objekt mit Abhängigkeiten, Ablauf-und Priorität und einen Delegaten können Sie Ihre Anwendung zu benachrichtigen, wenn das eingefügte Element aufgehoben wird die Cache.

Namespace:   System.Web.Caching
Assembly:  System.Web (in System.Web.dll)

public void Insert(
	string key,
	object value,
	CacheDependency dependencies,
	DateTime absoluteExpiration,
	TimeSpan slidingExpiration,
	CacheItemPriority priority,
	CacheItemRemovedCallback onRemoveCallback
)

Parameter

key
Type: System.String

Der Cacheschlüssel verwendet, um das Objekt zu verweisen.

value
Type: System.Object

Das Objekt in den Cache eingefügt werden soll.

dependencies
Type: System.Web.Caching.CacheDependency

Die Datei oder den Cache wichtigsten Abhängigkeiten für das Element. Wenn sich eine Abhängigkeit ändert, wird das Objekt ungültig und wird aus dem Cache entfernt. Wenn keine Abhängigkeiten vorhanden sind, enthält dieser Parameter null.

absoluteExpiration
Type: System.DateTime

Der Zeitpunkt, an dem das eingefügte Objekt abläuft und aus dem Cache entfernt wird. Um mögliche Probleme mit der lokalen Zeit wie Änderungen von der Normalzeit zur Sommerzeit zu vermeiden, verwenden Sie UtcNow statt Now für diesen Parameterwert. Bei Verwendung der absoluten Ablauf der slidingExpiration -Parameter muss sein NoSlidingExpiration.

slidingExpiration
Type: System.TimeSpan

Das Intervall zwischen dem Zeitpunkt des letzten Zugriffs auf das eingefügte Objekt und die Uhrzeit, zu der dieses Objekt abläuft. Wenn dieser Wert 20 Minuten entspricht, wird das Objekt läuft und 20 Minuten nach dem zuletzt erfolgten aus dem Cache entfernt. Wenn Sie die gleitende Ablaufzeit verwenden die absoluteExpiration -Parameter muss sein NoAbsoluteExpiration.

priority
Type: System.Web.Caching.CacheItemPriority

Die Kosten für das Objekt relativ zu anderen Elementen im Cache gespeichert werden, durch ausgedrückt die CacheItemPriority Enumeration. Dieser Wert wird vom Cache verwendet, wenn Objekten. Objekte mit niedrigerer Priorität werden vor Objekten mit höherer Priorität aus dem Cache entfernt.

onRemoveCallback
Type: System.Web.Caching.CacheItemRemovedCallback

Ein Delegat, der ggf. aufgerufen wird, wenn ein Objekt aus dem Cache entfernt wird. Damit können Sie um Anwendungen zu benachrichtigen, wenn ihre Objekte aus dem Cache gelöscht werden.

Exception Condition
ArgumentNullException

Der key-Parameter oder der value-Parameter ist null.

ArgumentOutOfRangeException

Festlegen der slidingExpiration -Parameter kleiner als TimeSpan.Zero oder die Entsprechung von mehr als einem Jahr.

ArgumentException

Die absoluteExpiration und slidingExpiration Parameter festgelegt sind für das Element, das Sie hinzufügen möchten die Cache.

Diese Methode überschreibt eine vorhandene Cache Element mit dem gleichen key Parameter.

Können nicht den absoluteExpiration und slidingExpiration Parameter. Wenn das zwischengespeicherte Element zu einem bestimmten Zeitpunkt ablaufen soll, legen Sie die absoluteExpiration Parameter, um die Uhrzeit und das slidingExpiration Parameter NoSlidingExpiration.

Wenn Sie beabsichtigen, dass das Element im Cache nach einem bestimmten Zeitraum ablaufen verstrichen seit dem letzten Zugriff auf das Element, Festlegen der slidingExpiration -Parameter auf das Ablaufintervall und die absoluteExpiration Parameter NoAbsoluteExpiration.

Im folgenden Beispiel wird veranschaulicht, wie eine Element mit hoher Priorität zuweisen, wenn Sie ihn in Ihre Anwendungsverzeichnis einfügen Cache Objekt.

System_CAPS_noteHinweis

Weitere Informationen zur Verwendung dieser Methode mit der CacheItemRemovedCallback delegieren, finden Sie unter How to: Notify an Application When an Item Is Removed from the Cache.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: