Cache.Insert Methode

  • Referenz

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 Einem Element beim Einfügen in das Cache Objekt Ihrer Anwendung eine hohe Priorität zugewiesen wird.

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 sie beabsichtigen, dass das Cacheelement zu einem bestimmten Zeitpunkt abläuft, legen Sie den absoluteExpiration Parameter auf den bestimmten Zeitpunkt 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

Gilt für:

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 Delegaten 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 sie beabsichtigen, dass das Cacheelement zu einem bestimmten Zeitpunkt abläuft, legen Sie den absoluteExpiration Parameter auf den bestimmten Zeitpunkt und den slidingExpiration Parameter auf fest NoSlidingExpiration.

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

Weitere Informationen

Gilt für:

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 mit dem key Parameter übereinstimmt. Das -Objekt, das dem Cache mithilfe dieser Überladung der Insert -Methode hinzugefügt wird, wird mit einer Priorität von Default, einem gleitenden Ablaufwert von NoSlidingExpirationund einem absoluten Ablaufwert von NoAbsoluteExpirationeingefügt.

Weitere Informationen

Gilt für:

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 mit dem key Parameter übereinstimmt. Das -Objekt, das dem Cache mithilfe dieser Überladung der Insert -Methode hinzugefügt wird, wird ohne Datei- oder Cacheabhängigkeiten, einer Priorität von Default, einem gleitenden Ablaufwert von NoSlidingExpirationund einem absoluten Ablaufwert von NoAbsoluteExpirationeingefügt.

Weitere Informationen

Gilt für:

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 einem absoluten Ablauf in den Cache einer Anwendung eingefügt wird.

Hinweis

Da diese Form der Insert -Methode Cacheabhängigkeiten unterstützt, müssen Sie den Parameter null als (Nothing in Visual Basic) in der durch Trennzeichen getrennten Liste von Parametern deklarierendependency, 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

Gilt für: