Cache.Insert Methode

Definition

Namespace:

System.Web.Caching

Assembly:

System.Web.dll

Fügt ein Element in das Cache-Objekt ein. Verwenden Sie eine der Versionen dieser Methode, um ein vorhandenes Cache-Element durch denselben key-Parameter zu überschreiben.

Überlädt

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Fügt ein Objekt in das Cache-Objekt ein, einschließlich von Abhängigkeiten, Ablauf- und Prioritätsrichtlinien sowie einem Delegaten, mit dem die Anwendung über das Entfernen des eingefügten Elements aus Cache benachrichtigt werden kann.
Insert(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.
Insert(String, Object, CacheDependency)	Fügt ein Objekt in den Cache ein, das Datei- oder Schlüsselabhängigkeiten besitzt.
Insert(String, Object)	Fügt ein Element mit einem Cacheschlüssel, der auf den Speicherort verweist, in das Cache-Objekt ein, wobei von der CacheItemPriority-Enumeration bereitgestellte Standardwerte verwendet werden.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Fügt ein Objekt mit Abhängigkeiten und Ablaufrichtlinien in den Cache ein.

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Fügt ein Objekt in das Cache-Objekt ein, einschließlich von Abhängigkeiten, Ablauf- und Prioritätsrichtlinien sowie einem Delegaten, mit dem die Anwendung über das Entfernen des eingefügten Elements aus Cache benachrichtigt werden kann.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);

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

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)

Parameter

key

String

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

value

Object

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

dependencies

CacheDependency

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

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 zu vermeiden, z. B. Änderungen von der Standardzeit zur Sommerzeit, verwenden Sie für diesen Parameterwert UtcNow statt Now. Wenn Sie die absolute Ablaufzeit verwenden, muss der slidingExpiration-Parameter NoSlidingExpiration sein.

slidingExpiration

TimeSpan

Das Intervall zwischen dem letzten Zugreifen auf das eingefügte Objekt und dem Ablaufen des Objekts. Wenn dieser Wert 20 Minuten entspricht, läuft das Objekt 20 Minuten nach dem letzten Zugriff ab und wird aus dem Cache entfernt. Wenn Sie die gleitende Ablaufzeit verwenden, muss der absoluteExpiration-Parameter NoAbsoluteExpiration sein.

priority

CacheItemPriority

Die Priorität des Objekts im Verhältnis zu den anderen im Cache gespeicherten Elementen, der durch die CacheItemPriority-Enumeration ausgedrückt wird. Dieser Wert wird vom Cache beim Entfernen von Objekten verwendet. Objekte mit niedrigerer Priorität werden vor Objekten mit höherer Priorität aus dem Cache entfernt.

onRemoveCallback

CacheItemRemovedCallback

Wenn bereitgestellt, ein Delegat, der beim Entfernen eines Objekts aus dem Cache aufgerufen wird. Hiermit können Sie Anwendungen benachrichtigen lassen, wenn zugehörige Objekte aus dem Cache gelöscht werden.

Ausnahmen

ArgumentNullException

Der key-Parameter oder der value-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.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie einem Element hohe Priorität zuweisen, wenn Sie es in das Cache Objekt Ihrer Anwendung einfügen.

Hinweis

Weitere Informationen zur Verwendung dieser Methode mit dem CacheItemRemovedCallback Delegaten finden Sie unter Vorgehensweise: Benachrichtigen einer Anwendung, wenn ein Element aus dem Cache entfernt wird.

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

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

Hinweise

Diese Methode überschreibt ein vorhandenes Cache Element mit demselben key Parameter.

Sie können nicht sowohl die absoluteExpiration Parameter als slidingExpiration auch festlegen. Wenn das Cacheelement zu einem bestimmten Zeitpunkt abläuft, legen Sie den absoluteExpiration Parameter auf die bestimmte Zeit und den slidingExpiration Parameter auf fest NoSlidingExpiration.

Wenn Sie beabsichtigen, dass das Cacheelement abläuft, nachdem eine bestimmte Zeit seit dem letzten Zugriff auf das Element vergangen ist, legen Sie den slidingExpiration Parameter auf das Ablaufintervall und den absoluteExpiration Parameter auf fest NoAbsoluteExpiration.

Weitere Informationen

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Zwischenspeichern von Anwendungsdaten

Insert(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.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);

public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)

Parameter

key

String

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

value

Object

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

dependencies

CacheDependency

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

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 zu vermeiden, z. B. Änderungen von der Standardzeit zur Sommerzeit, verwenden Sie für diesen Parameterwert UtcNow statt Now. Wenn Sie die absolute Ablaufzeit verwenden, muss der slidingExpiration-Parameter auf NoSlidingExpiration festgelegt werden.

slidingExpiration

TimeSpan

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 letzten Zugriff ab und wird aus dem Cache entfernt. Wenn Sie die gleitende Ablaufzeit verwenden, muss der absoluteExpiration-Parameter auf NoAbsoluteExpiration festgelegt werden.

onUpdateCallback

CacheItemUpdateCallback

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.

Ausnahmen

ArgumentNullException

Der Parameter key, value oder onUpdateCallback 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.

Hinweise

Mit Insert der -Methode können Sie ein neues Element in den Cache einfügen und einen Delegaten bereitstellen, der aufgerufen wird, bevor das Element aus dem Cache entfernt wird. Im Delegat können Sie das zwischengespeicherte Element aktualisieren und so verhindern, dass es aus dem Cache entfernt wird.

Diese Methode überschreibt ein vorhandenes Cache Element mit demselben key Parameter.

Sie können nicht sowohl die absoluteExpiration Parameter als slidingExpiration auch festlegen. Wenn das Cacheelement zu einem bestimmten Zeitpunkt abläuft, legen Sie den absoluteExpiration Parameter auf die bestimmte Zeit und den slidingExpiration Parameter auf fest NoSlidingExpiration.

Wenn Sie beabsichtigen, dass das Cacheelement nach einem bestimmten Zeitraum abläuft, seit auf das Element zuletzt zugegriffen wurde, legen Sie den slidingExpiration Parameter auf das Ablaufintervall und den absoluteExpiration Parameter auf NoAbsoluteExpirationfest.

Weitere Informationen

• CacheItemUpdateCallback

Insert(String, Object, CacheDependency)

Fügt ein Objekt in den Cache ein, das Datei- oder Schlüsselabhängigkeiten besitzt.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);

public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies);

member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency)

Parameter

key

String

Der Cacheschlüssel, mit dem das Element angegeben wird.

value

Object

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

dependencies

CacheDependency

Die Datei- oder Cacheschlüsselabhängigkeiten des eingefügten Objekts. 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.

Ausnahmen

ArgumentNullException

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Element mit einer Cacheabhängigkeit von einer XML-Konfigurationsdatei in den Cache einer Anwendung eingefügt wird.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

Hinweise

Diese Methode überschreibt ein vorhandenes Cacheelement, dessen Schlüssel dem key Parameter entspricht. Das -Objekt, das dem Cache mithilfe dieser Überladung der Insert -Methode hinzugefügt wird, wird mit der Priorität , Defaulteinem gleitenden Ablaufwert von NoSlidingExpirationund einem absoluten Ablaufwert von NoAbsoluteExpirationeingefügt.

Weitere Informationen

• CacheDependency

Insert(String, Object)

Fügt ein Element mit einem Cacheschlüssel, der auf den Speicherort verweist, in das Cache-Objekt ein, wobei von der CacheItemPriority-Enumeration bereitgestellte Standardwerte verwendet werden.

public:
 void Insert(System::String ^ key, System::Object ^ value);

public void Insert (string key, object value);

member this.Insert : string * obj -> unit

Public Sub Insert (key As String, value As Object)

Parameter

key

String

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

value

Object

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

Ausnahmen

ArgumentNullException

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Element in den Cache einer Anwendung eingefügt wird.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Hinweise

Diese Methode überschreibt ein vorhandenes Cacheelement, dessen Schlüssel dem key Parameter entspricht. Das -Objekt, das dem Cache mithilfe dieser Überladung der Insert -Methode hinzugefügt wird, wird ohne Datei- oder Cacheabhängigkeiten, eine Priorität von Default, einen gleitenden Ablaufwert von NoSlidingExpirationund einen absoluten Ablaufwert von NoAbsoluteExpirationeingefügt.

Weitere Informationen

• Zwischenspeichern von Anwendungsdaten

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

Fügt ein Objekt mit Abhängigkeiten und Ablaufrichtlinien in den Cache ein.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);

public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)

Parameter

key

String

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

value

Object

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

dependencies

CacheDependency

Die Datei- oder Cacheschlüsselabhängigkeiten des eingefügten Objekts. 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

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 zu vermeiden, z. B. Änderungen von der Standardzeit zur Sommerzeit, verwenden Sie für diesen Parameterwert UtcNow statt Now. Wenn Sie die absolute Ablaufzeit verwenden, muss der slidingExpiration-Parameter NoSlidingExpiration sein.

slidingExpiration

TimeSpan

Der Zeitraum zwischen dem Zeitpunkt des letzten Zugriffs auf das eingefügte Objekt und dem Zeitpunkt des Ablaufs dieses Objekts. Wenn dieser Wert 20 Minuten entspricht, läuft das Objekt 20 Minuten nach dem letzten Zugriff ab und wird aus dem Cache entfernt. Wenn Sie die gleitende Ablaufzeit verwenden, muss der absoluteExpiration-Parameter NoAbsoluteExpiration sein.

Ausnahmen

ArgumentNullException

Der key-Parameter oder der value-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.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Element mit absolutem Ablauf in den Cache einer Anwendung eingefügt wird.

Hinweis

Da diese Form der Insert Methode Cacheabhängigkeiten unterstützt, müssen Sie den dependency Parameter als null (Nothing in Visual Basic) in der durch Trennzeichen getrennten Liste der Parameter deklarieren, wenn das Element keine Abhängigkeiten aufweist.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

Im folgenden Beispiel wird veranschaulicht, wie ein Element mit einem gleitenden Ablauf in den Cache eingefügt wird.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));

Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

Hinweise

Diese Methode überschreibt ein vorhandenes Cache Element mit demselben key Parameter.

Wenn der slidingExpiration Parameter auf NoSlidingExpirationfestgelegt ist, ist der gleitende Ablauf deaktiviert. Wenn Sie den slidingExpiration Parameter auf größer als Zerofestlegen, wird der absoluteExpiration Parameter auf Now plus den im slidingExpiration Parameter enthaltenen Wert festgelegt. Wenn das Element vor der vom absoluteExpiration Parameter angegebenen Zeitspanne aus dem Cache angefordert wird, wird das Element erneut im Cache platziert und absoluteExpiration erneut auf DateTime.Now plus den im slidingExpiration Parameter enthaltenen Wert festgelegt. Wenn das Element nicht vor dem Datum im absoluteExpiration Parameter aus dem Cache angefordert wird, wird das Element aus dem Cache entfernt. Das dem Cache mithilfe dieser Überladung der insert-Methode hinzugefügte Element wird mit der Priorität eingefügt Default.

Weitere Informationen

• DateTime
• TimeSpan
• Zwischenspeichern von Anwendungsdaten