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 mit demselben key Parameter zu überschreiben.
Überlädt
| Name | Beschreibung |
|---|---|
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Fügt ein Objekt mit Abhängigkeiten, Ablauf- und Prioritätsrichtlinien in das Cache Objekt ein, und eine Stellvertretung, die Sie verwenden können, um die Anwendung zu benachrichtigen, wenn das eingefügte Element aus dem |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Fügt ein Objekt zusammen mit Abhängigkeiten, Ablaufrichtlinien und einem Delegaten in das Cache Objekt ein, mit dem Sie die Anwendung benachrichtigen können, bevor das Element aus dem Cache entfernt wird. |
| Insert(String, Object, CacheDependency) |
Fügt ein Objekt in die Cache Datei- oder Schlüsselabhängigkeiten ein. |
| Insert(String, Object) |
Fügt ein Element mit einem Cacheschlüssel in das Cache Objekt ein, um auf seinen Speicherort zu verweisen, wobei Standardwerte verwendet werden, die von der CacheItemPriority Enumeration bereitgestellt werden. |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan) |
Fügt ein Objekt in die Cache Abhängigkeiten und Ablaufrichtlinien ein. |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Fügt ein Objekt mit Abhängigkeiten, Ablauf- und Prioritätsrichtlinien in das Cache Objekt ein, und eine Stellvertretung, die Sie verwenden können, um die Anwendung zu benachrichtigen, wenn das eingefügte Element aus dem CacheObjekt entfernt wird.
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, der zum Verweisen auf das Objekt verwendet wird.
- value
- Object
Das Objekt, das im Cache eingefügt werden soll.
- dependencies
- CacheDependency
Die Datei- oder Cacheschlüsselabhängigkeiten für das Element. Wenn eine Abhängigkeit geändert wird, wird das Objekt ungültig und aus dem Cache entfernt. Wenn keine Abhängigkeiten vorhanden sind, enthält nulldieser Parameter .
- absoluteExpiration
- DateTime
Die Uhrzeit, zu der das eingefügte Objekt abläuft und aus dem Cache entfernt wird. Um mögliche Probleme mit der Ortszeit zu vermeiden, z. B. Änderungen von Standardzeit zu Sommerzeit, verwenden Sie UtcNow anstelle Now dieses Parameterwerts. Wenn Sie den absoluten Ablauf verwenden, muss der slidingExpiration Parameter sein NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Das Intervall zwischen dem Zeitpunkt, zu dem das eingefügte Objekt zuletzt zugegriffen wurde, und dem Zeitpunkt, zu dem das Objekt abläuft. Wenn dieser Wert 20 Minuten entspricht, läuft das Objekt ab und wird 20 Minuten nach dem letzten Zugriff aus dem Cache entfernt. Wenn Sie den Ablauf des Gleitens verwenden, muss der absoluteExpiration Parameter sein NoAbsoluteExpiration.
- priority
- CacheItemPriority
Die Kosten des Objekts relativ zu anderen im Cache gespeicherten Elementen, wie durch die CacheItemPriority Enumeration ausgedrückt. Dieser Wert wird vom Cache verwendet, wenn objekte gelöscht werden; Objekte mit niedrigeren Kosten werden aus dem Cache entfernt, bevor Objekte mit höheren Kosten anfallen.
- onRemoveCallback
- CacheItemRemovedCallback
Eine Stellvertretung, die aufgerufen wird, wenn ein Objekt aus dem Cache entfernt wird. Sie können dies verwenden, um Anwendungen zu benachrichtigen, wenn ihre Objekte aus dem Cache gelöscht werden.
Ausnahmen
Der key Parameter ist valuenull.
Sie legen den slidingExpiration Parameter auf weniger als TimeSpan.Zero oder das Äquivalent von mehr als einem Jahr fest.
Die Parameter und absoluteExpiration Die slidingExpiration Parameter werden für das Element festgelegt, das Sie dem CacheElement hinzufügen möchten.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie ein Element mit hoher Priorität zuweisen, wenn Sie es in das Cache Objekt Ihrer Anwendung einfügen.
Note
Weitere Informationen zur Verwendung dieser Methode mit dem CacheItemRemovedCallback Delegaten 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);
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 Parameter absoluteExpiration als auch die slidingExpiration Parameter festlegen. Wenn sie beabsichtigen, dass das Cacheelement zu einem bestimmten Zeitpunkt abläuft, legen Sie den absoluteExpiration Parameter auf den jeweiligen Zeitpunkt und den slidingExpiration Parameter auf NoSlidingExpiration.
Wenn Sie beabsichtigen, dass das Cacheelement abläuft, nachdem ein bestimmter Zeitraum seit dem letzten Zugriff auf das Element vergangen ist, legen Sie den slidingExpiration Parameter auf das Ablaufintervall und den absoluteExpiration Parameter auf NoAbsoluteExpiration.
Weitere Informationen
Gilt für:
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Fügt ein Objekt zusammen mit Abhängigkeiten, Ablaufrichtlinien und einem Delegaten in das Cache Objekt ein, mit dem Sie die Anwendung benachrichtigen können, bevor das Element aus dem Cache entfernt wird.
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, der zum Verweisen auf das Objekt verwendet wird.
- value
- Object
Das Objekt, das in den Cache eingefügt werden soll.
- dependencies
- CacheDependency
Die Datei- oder Cacheschlüsselabhängigkeiten für das Element. Wenn eine Abhängigkeit geändert wird, wird das Objekt ungültig und aus dem Cache entfernt. Wenn keine Abhängigkeiten vorhanden sind, enthält nulldieser Parameter .
- absoluteExpiration
- DateTime
Die Uhrzeit, zu der das eingefügte Objekt abläuft und aus dem Cache entfernt wird. Um mögliche Probleme mit der Ortszeit zu vermeiden, z. B. Änderungen von Standardzeit zu Sommerzeit, verwenden Sie UtcNow anstelle Now dieses Parameterwerts. Wenn Sie den absoluten Ablauf verwenden, muss der slidingExpiration Parameter auf NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Das Intervall zwischen dem Zeitpunkt, zu dem das zwischengespeicherte Objekt zuletzt zugegriffen wurde, und dem Zeitpunkt, zu dem das Objekt abläuft. Wenn dieser Wert 20 Minuten entspricht, läuft das Objekt ab und wird 20 Minuten nach dem letzten Zugriff aus dem Cache entfernt. Wenn Sie den Ablauf des Gleitens verwenden, muss der absoluteExpiration Parameter auf NoAbsoluteExpiration. festgelegt werden.
- onUpdateCallback
- CacheItemUpdateCallback
Eine Stellvertretung, die aufgerufen wird, bevor das Objekt aus dem Cache entfernt wird. Sie können dies verwenden, um das zwischengespeicherte Element zu aktualisieren und sicherzustellen, dass es nicht aus dem Cache entfernt wird.
Ausnahmen
Der key, value, oder onUpdateCallback Parameter ist null.
Sie legen den slidingExpiration Parameter auf weniger als TimeSpan.Zero oder das Äquivalent von mehr als einem Jahr fest.
Die Parameter und absoluteExpiration Die slidingExpiration Parameter werden für das Element festgelegt, das Sie dem CacheElement hinzufügen möchten.
-oder-
Der dependencies Parameter ist null, und der absoluteExpiration Parameter ist auf festgelegt NoAbsoluteExpiration, und der slidingExpiration Parameter wird auf NoSlidingExpiration.
Hinweise
Mit der Insert Methode können Sie ein neues Element im Cache einfügen und einen Delegaten bereitstellen, der aufgerufen wird, bevor das Element aus dem Cache entfernt wird. In der Stellvertretung können Sie das zwischengespeicherte Element aktualisieren und dadurch 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 Parameter absoluteExpiration als auch die slidingExpiration Parameter festlegen. Wenn sie beabsichtigen, dass das Cacheelement zu einem bestimmten Zeitpunkt abläuft, legen Sie den absoluteExpiration Parameter auf den jeweiligen Zeitpunkt und den slidingExpiration Parameter auf NoSlidingExpiration.
Wenn Sie beabsichtigen, dass das Cacheelement nach einem festgelegten Zeitraum seit dem letzten Zugriff auf das Element abläuft, legen Sie den slidingExpiration Parameter auf das Ablaufintervall fest und legen den absoluteExpiration Parameter auf NoAbsoluteExpiration.
Weitere Informationen
Gilt für:
Insert(String, Object, CacheDependency)
Fügt ein Objekt in die Cache Datei- oder Schlüsselabhängigkeiten ein.
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, der zum Identifizieren des Elements verwendet wird.
- value
- Object
Das Objekt, das im Cache eingefügt werden soll.
- dependencies
- CacheDependency
Die Datei- oder Cacheschlüsselabhängigkeiten für das eingefügte Objekt. Wenn eine Abhängigkeit geändert wird, wird das Objekt ungültig und aus dem Cache entfernt. Wenn keine Abhängigkeiten vorhanden sind, enthält nulldieser Parameter .
Ausnahmen
Der key Parameter ist valuenull.
Beispiele
Das folgende Beispiel veranschaulicht, wie ein Element in den Cache einer Anwendung mit einer Cacheabhängigkeit von einer XML-Konfigurationsdatei 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 mithilfe dieser Überladung der Insert Methode zum Cache 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 in das Cache Objekt ein, um auf seinen Speicherort zu verweisen, wobei Standardwerte verwendet werden, die von der CacheItemPriority Enumeration bereitgestellt 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, der zum Verweisen auf das Element verwendet wird.
- value
- Object
Das Objekt, das in den Cache eingefügt werden soll.
Ausnahmen
Der key Parameter ist valuenull.
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 mithilfe dieser Überladung der Insert Methode zum Cache hinzugefügt wird, wird ohne Datei- oder Cacheabhängigkeiten, eine Priorität von Default, einen gleitenden Ablaufwert von NoSlidingExpirationund einen absoluten Ablaufwert von NoAbsoluteExpiration.
Weitere Informationen
Gilt für:
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Fügt ein Objekt in die Cache Abhängigkeiten und Ablaufrichtlinien 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, der zum Verweisen auf das Objekt verwendet wird.
- value
- Object
Das Objekt, das im Cache eingefügt werden soll.
- dependencies
- CacheDependency
Die Datei- oder Cacheschlüsselabhängigkeiten für das eingefügte Objekt. Wenn eine Abhängigkeit geändert wird, wird das Objekt ungültig und aus dem Cache entfernt. Wenn keine Abhängigkeiten vorhanden sind, enthält nulldieser Parameter .
- absoluteExpiration
- DateTime
Die Uhrzeit, zu der das eingefügte Objekt abläuft und aus dem Cache entfernt wird. Um mögliche Probleme mit der Ortszeit zu vermeiden, z. B. Änderungen von Standardzeit zu Sommerzeit, verwenden Sie UtcNow anstelle Now dieses Parameterwerts. Wenn Sie den absoluten Ablauf verwenden, muss der slidingExpiration Parameter sein NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Das Intervall zwischen dem Zeitpunkt, zu dem das eingefügte Objekt zuletzt zugegriffen wird, und dem Zeitpunkt, zu dem das Objekt abläuft. Wenn dieser Wert 20 Minuten entspricht, läuft das Objekt ab und wird 20 Minuten nach dem letzten Zugriff aus dem Cache entfernt. Wenn Sie den Ablauf des Gleitens verwenden, muss der absoluteExpiration Parameter sein NoAbsoluteExpiration.
Ausnahmen
Der key Parameter ist valuenull.
Sie legen den slidingExpiration Parameter auf weniger als TimeSpan.Zero oder das Äquivalent von mehr als einem Jahr fest.
Die Parameter und absoluteExpiration Die slidingExpiration Parameter werden für das Element festgelegt, das Sie dem CacheElement hinzufügen möchten.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie ein Element mit einem absoluten Ablauf in den Cache einer Anwendung eingefügt wird.
Note
Da diese Form der Insert-Methode Cacheabhängigkeiten unterstützt, müssen Sie den Parameter dependency als null (Nothing in Visual Basic) in der durch Trennzeichen getrennten Liste der Parameter deklarieren.
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 Sie ein Element mit einem gleitenden Ablauf in den Cache einfügen.
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 Parameter auf slidingExpiration festgelegt ist, ist der NoSlidingExpiration Ablauf des Gleitens deaktiviert. Wenn Sie den slidingExpiration Parameter auf größer als Zerofestlegen, wird der absoluteExpiration Parameter auf Now plus den wert im slidingExpiration Parameter festgelegt. Wenn das Element aus dem Cache vor der vom Parameter angegebenen absoluteExpiration Zeitspanne angefordert wird, wird das Element erneut im Cache platziert, und absoluteExpiration es wird erneut auf DateTime.Now plus der 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 Element, das dem Cache mithilfe dieser Überladung der Insert-Methode hinzugefügt wird, wird mit einer Priorität eingefügt Default.
