Insert Methode (String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
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, CacheItemUpdateCallback)

 

Fügt ein Objekt in das Cache-Objekt mit Abhängigkeiten, Ablaufrichtlinien sowie einem Delegaten ein, mit dem die Anwendung vor dem Entfernen des Elements aus dem Cache benachrichtigt werden kann.

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

public void Insert(
	string key,
	object value,
	CacheDependency dependencies,
	DateTime absoluteExpiration,
	TimeSpan slidingExpiration,
	CacheItemUpdateCallback onUpdateCallback
)

Parameter

key

Der Cacheschlüssel, mit dem auf das Objekt verwiesen wird.

value

Das Objekt, das in den Cache eingefügt werden soll.

dependencies

Die Datei- oder Cacheschlüsselabhängigkeiten des Elements.Wenn sich eine der Abhängigkeiten ändert, wird das Objekt ungültig und aus dem Cache entfernt.Wenn keine Abhängigkeiten bestehen, enthält dieser Parameter null.

absoluteExpiration

Der Zeitpunkt, an dem das eingefügte Objekt abläuft und aus dem Cache entfernt wird.Um mögliche Probleme mit der lokalen Zeit zu vermeiden, z. B. Änderungen von der Standardzeit zur Sommerzeit, verwenden Sie für diesen Parameterwert Now statt UtcNow.Wenn Sie die absolute Ablaufzeit verwenden, muss der slidingExpiration-Parameter auf NoSlidingExpiration festgelegt werden.

slidingExpiration

Das Intervall zwischen dem letzten Zugriff auf das zwischengespeicherte Objekt und dem Ablaufzeitpunkt des Objekts.Wenn dieser Wert 20 Minuten entspricht, läuft das Objekt 20 Minuten nach dem zuletzt erfolgten Zugriff ab und wird aus dem Cache entfernt.Wenn Sie die gleitende Ablaufzeit verwenden, muss der absoluteExpiration-Parameter auf NoAbsoluteExpiration festgelegt werden.

onUpdateCallback

Ein Delegat, der vor dem Entfernen eines Objekts aus dem Cache aufgerufen wird.Hiermit kann das zwischengespeicherte Element aktualisiert und sichergestellt werden, dass es nicht aus dem Cache entfernt wird.

Exception Condition
ArgumentNullException

Der key-Parameter, value-Parameter oder onUpdateCallback-Parameter ist null.

ArgumentOutOfRangeException

Der slidingExpiration-Parameter wurde auf weniger als TimeSpan.Zero oder die Entsprechung von mehr als einem Jahr fest.

ArgumentException

Für das Element, das Sie dem Cache hinzufügen möchten, sind sowohl der absoluteExpiration-Parameter als auch der slidingExpiration-Parameter festgelegt.

- oder -

Der dependencies-Parameter ist null, der absoluteExpiration-Parameter ist auf NoAbsoluteExpiration festgelegt, und der slidingExpiration-Parameter ist auf NoSlidingExpiration festgelegt.

Mit der Insert-Methode können Sie ein neues Element in den Cache einfügen und einen Delegaten bereitstellen, der vor dem Entfernen des Elements aus dem Cache aufgerufen wird.In diesem Delegaten können Sie das zwischengespeicherte Element aktualisieren und damit verhindern, dass es aus dem Cache entfernt wird.

Diese Methode überschreibt ein vorhandenes Cache-Element durch denselben key-Parameter.

Der absoluteExpiration-Parameter und der slidingExpiration-Parameter können nicht gleichzeitig festgelegt werden.Wenn das zwischengespeicherte Element zu einem bestimmten Zeitpunkt ablaufen soll, legen Sie den absoluteExpiration-Parameter auf diesen Zeitpunkt und den slidingExpiration-Parameter auf NoSlidingExpiration fest.

Wenn das zwischengespeicherte Element nach einem bestimmten Zeitraum nach dem letzten Zugriff auf das Element ablaufen soll, legen Sie den slidingExpiration-Parameter auf das Ablaufintervall und den absoluteExpiration-Parameter auf NoAbsoluteExpiration fest.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen:
© 2016 Microsoft