Cache.Insert Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |
| 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 -> unitPublic 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
Der key-Parameter oder der value-Parameter ist null.
Der slidingExpiration-Parameter wurde auf weniger als TimeSpan.Zero oder die Entsprechung von mehr als einem Jahr fest.
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
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 -> unitPublic 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
Der Parameter key, value oder onUpdateCallback ist null.
Der slidingExpiration-Parameter wurde auf weniger als TimeSpan.Zero oder die Entsprechung von mehr als einem Jahr fest.
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
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 -> unitPublic 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
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
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 -> unitPublic 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
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
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 -> unitPublic 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
Der key-Parameter oder der value-Parameter ist null.
Der slidingExpiration-Parameter wurde auf weniger als TimeSpan.Zero oder die Entsprechung von mehr als einem Jahr fest.
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.
