Cache.Insert Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vloží položku do objektu Cache . Použijte jednu z verzí této metody k přepsání existující Cache položky se stejným key parametrem.
Přetížení
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Vloží objekt do objektu Cache se závislostmi, zásadami vypršení platnosti a priority a delegáta, který můžete použít k upozornění aplikace, když je vložená položka odebrána z objektu |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Vloží objekt do objektu Cache společně se závislostmi, zásadami vypršení platnosti a delegátem, který můžete použít k upozornění aplikace před odebráním položky z mezipaměti. |
| Insert(String, Object, CacheDependency) |
Vloží objekt do objektu Cache , který má závislosti souborů nebo klíčů. |
| Insert(String, Object) |
Vloží položku do objektu Cache s klíčem mezipaměti, aby odkazovala na jeho umístění pomocí výchozích hodnot uvedených ve výčtu CacheItemPriority . |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan) |
Vloží objekt do objektu Cache se závislostmi a zásadami vypršení platnosti. |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Vloží objekt do objektu Cache se závislostmi, zásadami vypršení platnosti a priority a delegáta, který můžete použít k upozornění aplikace, když je vložená položka odebrána z objektu Cache.
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)Parametry
- key
- String
Klíč mezipaměti použitý k odkazování na objekt.
- value
- Object
Objekt, který se má vložit do mezipaměti.
- dependencies
- CacheDependency
Závislosti klíče souboru nebo mezipaměti pro položku. Když se změní jakákoli závislost, objekt se stane neplatným a odebere se z mezipaměti. Pokud neexistují žádné závislosti, obsahuje tento parametr null.
- absoluteExpiration
- DateTime
Čas, kdy platnost vloženého objektu vyprší a je odebrán z mezipaměti. Chcete-li se vyhnout možným problémům s místním časem, jako jsou změny ze standardního času na letní čas, použijte UtcNow místo Now pro tuto hodnotu parametru. Pokud používáte absolutní vypršení platnosti, slidingExpiration parametr musí být NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interval mezi časem posledního přístupu k vloženým objektu a časem, kdy tento objekt vyprší. Pokud je tato hodnota ekvivalentní 20 minut, platnost objektu vyprší a odebere se z mezipaměti 20 minut po posledním přístupu. Pokud používáte klouzavé vypršení platnosti, absoluteExpiration musí být NoAbsoluteExpirationparametr .
- priority
- CacheItemPriority
Náklady na objekt vzhledem k ostatním položkám uloženým v mezipaměti vyjádřené výčtem CacheItemPriority . Tuto hodnotu používá mezipaměť při vyřazování objektů; objekty s nižšími náklady se z mezipaměti odeberou před objekty s vyššími náklady.
- onRemoveCallback
- CacheItemRemovedCallback
Delegát, který bude volána při odebrání objektu z mezipaměti, pokud je k dispozici. Můžete ho použít k oznámení aplikacím, když jsou jejich objekty odstraněny z mezipaměti.
Výjimky
Parametr key nebo value je null.
Parametr nastavíte slidingExpiration na hodnotu kratší než TimeSpan.Zero nebo ekvivalent více než jeden rok.
Parametry absoluteExpiration a slidingExpiration jsou nastavené pro položku, kterou se pokoušíte přidat do Cache.
Příklady
Následující příklad ukazuje, jak přiřadit položku s vysokou prioritou při jejím vložení do objektu Cache aplikace.
Poznámka
Další informace o použití této metody s delegátem najdete v CacheItemRemovedCallback tématu Postupy: Upozornění aplikace při odebrání položky z mezipaměti.
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)
Poznámky
Tato metoda přepíše existující Cache položku se stejným key parametrem.
Parametry a absoluteExpirationslidingExpiration nelze nastavit. Pokud chcete, aby platnost položky mezipaměti vypršela v určitou dobu, nastavíte absoluteExpiration parametr na konkrétní čas a slidingExpiration parametr na NoSlidingExpirationhodnotu .
Pokud chcete, aby platnost položky mezipaměti vypršela po uplynutí určité doby od posledního přístupu k položce, nastavíte slidingExpiration parametr na interval vypršení platnosti a absoluteExpiration parametr na NoAbsoluteExpirationhodnotu .
Viz také
Platí pro
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Vloží objekt do objektu Cache společně se závislostmi, zásadami vypršení platnosti a delegátem, který můžete použít k upozornění aplikace před odebráním položky z mezipaměti.
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)Parametry
- key
- String
Klíč mezipaměti, který se používá k odkazování na objekt.
- value
- Object
Objekt, který se má vložit do mezipaměti.
- dependencies
- CacheDependency
Závislosti klíče souboru nebo mezipaměti pro položku. Když se změní jakákoli závislost, objekt se stane neplatným a odebere se z mezipaměti. Pokud neexistují žádné závislosti, obsahuje tento parametr null.
- absoluteExpiration
- DateTime
Čas, kdy platnost vloženého objektu vyprší a je odebrán z mezipaměti. Pokud se chcete vyhnout možným problémům s místním časem, jako jsou změny ze standardního času na letní čas, použijte UtcNow pro tuto hodnotu parametru Now místo hodnoty. Pokud používáte absolutní vypršení platnosti, slidingExpiration musí být parametr nastaven na NoSlidingExpirationhodnotu .
- slidingExpiration
- TimeSpan
Interval mezi časem posledního přístupu k objektu v mezipaměti a časem, kdy tento objekt vyprší. Pokud je tato hodnota ekvivalentní 20 minut, platnost objektu vyprší a odebere se z mezipaměti 20 minut po posledním přístupu. Pokud používáte klouzavé vypršení platnosti, absoluteExpiration musí být parametr nastaven na NoAbsoluteExpirationhodnotu .
- onUpdateCallback
- CacheItemUpdateCallback
Delegát, který bude volána před odebráním objektu z mezipaměti. Tuto možnost můžete použít k aktualizaci položky uložené v mezipaměti a k zajištění, že se z mezipaměti neodebere.
Výjimky
Parametr key, valuenebo onUpdateCallback je null.
Parametr nastavíte slidingExpiration na hodnotu kratší než TimeSpan.Zero nebo ekvivalent více než jeden rok.
Parametry absoluteExpiration a slidingExpiration jsou nastavené pro položku, kterou se pokoušíte přidat do Cache.
-nebo-
Parametr dependencies je nulla parametr absoluteExpiration je nastavený na NoAbsoluteExpirationhodnotu a slidingExpiration parametr je nastavený na NoSlidingExpirationhodnotu .
Poznámky
Metoda Insert umožňuje vložit novou položku do mezipaměti a poskytnout delegáta, který je volána před odebráním položky z mezipaměti. V delegátu můžete aktualizovat položku uloženou v mezipaměti a tím zabránit jejímu odebrání z mezipaměti.
Tato metoda přepíše existující Cache položku se stejným key parametrem.
Parametry a absoluteExpirationslidingExpiration nelze nastavit. Pokud chcete, aby platnost položky mezipaměti vypršela v určitou dobu, nastavíte absoluteExpiration parametr na konkrétní čas a slidingExpiration parametr na NoSlidingExpirationhodnotu .
Pokud chcete, aby platnost položky mezipaměti vypršela po nastaveném časovém období od posledního přístupu k této položce, nastavíte slidingExpiration parametr na interval vypršení platnosti a parametr nastavíte absoluteExpiration na NoAbsoluteExpirationhodnotu .
Viz také
Platí pro
Insert(String, Object, CacheDependency)
Vloží objekt do objektu Cache , který má závislosti souborů nebo klíčů.
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)Parametry
- key
- String
Klíč mezipaměti použitý k identifikaci položky
- value
- Object
Objekt, který se má vložit do mezipaměti.
- dependencies
- CacheDependency
Závislosti klíče souboru nebo mezipaměti pro vložený objekt. Když se změní jakákoli závislost, objekt se stane neplatným a odebere se z mezipaměti. Pokud neexistují žádné závislosti, obsahuje tento parametr null.
Výjimky
Parametr key nebo value je null.
Příklady
Následující příklad ukazuje, jak vložit položku do mezipaměti aplikace se závislostí mezipaměti na konfiguračním souboru XML.
Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));
Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))
Poznámky
Tato metoda přepíše existující položku mezipaměti, jejíž klíč odpovídá parametru key . Objekt přidaný do mezipaměti pomocí tohoto přetížení Insert metody je vložen s prioritou Default, posunutou hodnotou NoSlidingExpirationvypršení platnosti , a absolutní hodnotou vypršení platnosti .NoAbsoluteExpiration
Viz také
Platí pro
Insert(String, Object)
Vloží položku do objektu Cache s klíčem mezipaměti, aby odkazovala na jeho umístění pomocí výchozích hodnot uvedených ve výčtu CacheItemPriority .
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)Parametry
- key
- String
Klíč mezipaměti použitý k odkazování na položku
- value
- Object
Objekt, který se má vložit do mezipaměti.
Výjimky
Parametr key nebo value je null.
Příklady
Následující příklad ukazuje, jak vložit položku do mezipaměti aplikace.
Cache.Insert("DSN", connectionString);
Cache.Insert("DSN", connectionString)
Poznámky
Tato metoda přepíše existující položku mezipaměti, jejíž klíč odpovídá parametru key . Objekt přidaný do mezipaměti pomocí tohoto přetížení Insert metody se vloží bez závislostí souborů nebo mezipaměti, priority Default, posunutá hodnota NoSlidingExpirationvypršení platnosti , a absolutní hodnota vypršení platnosti .NoAbsoluteExpiration
Viz také
Platí pro
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Vloží objekt do objektu Cache se závislostmi a zásadami vypršení platnosti.
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)Parametry
- key
- String
Klíč mezipaměti použitý k odkazování na objekt.
- value
- Object
Objekt, který se má vložit do mezipaměti.
- dependencies
- CacheDependency
Závislosti klíče souboru nebo mezipaměti pro vložený objekt. Když se změní jakákoli závislost, objekt se stane neplatným a odebere se z mezipaměti. Pokud neexistují žádné závislosti, obsahuje tento parametr null.
- absoluteExpiration
- DateTime
Čas, kdy platnost vloženého objektu vyprší a je odebrán z mezipaměti. Chcete-li se vyhnout možným problémům s místním časem, jako jsou změny ze standardního času na letní čas, použijte UtcNow místo Now pro tuto hodnotu parametru. Pokud používáte absolutní vypršení platnosti, slidingExpiration parametr musí být NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interval mezi časem posledního přístupu k vloženým objektu a časem, kdy vyprší platnost daného objektu. Pokud je tato hodnota ekvivalentní 20 minut, platnost objektu vyprší a odebere se z mezipaměti 20 minut po posledním přístupu. Pokud používáte klouzavé vypršení platnosti, absoluteExpiration musí být NoAbsoluteExpirationparametr .
Výjimky
Parametr key nebo value je null.
Parametr nastavíte slidingExpiration na hodnotu kratší než TimeSpan.Zero nebo ekvivalent více než jeden rok.
Parametry absoluteExpiration a slidingExpiration jsou nastavené pro položku, kterou se pokoušíte přidat do Cache.
Příklady
Následující příklad ukazuje, jak vložit položku do mezipaměti aplikace s absolutním vypršením platnosti.
Poznámka
Vzhledem k tomu, že tato forma Insert metody podporuje závislosti mezipaměti, pokud položka nemá žádné závislosti, musíte deklarovat dependency parametr jako null (Nothing v jazyce Visual Basic) v seznamu parametrů oddělených čárkami.
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)
Následující příklad ukazuje, jak vložit položku do mezipaměti s posunutým vypršením platnosti.
Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));
Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))
Poznámky
Tato metoda přepíše existující Cache položku se stejným key parametrem.
slidingExpiration Pokud je parametr nastavený na NoSlidingExpirationhodnotu , je klouzavé vypršení platnosti zakázáno. Pokud nastavíte slidingExpiration parametr na hodnotu větší než Zero, absoluteExpiration parametr se nastaví na Now plus hodnota obsažená v parametru slidingExpiration . Pokud je položka požadována z mezipaměti před dobou určenou parametrem absoluteExpiration , bude položka znovu umístěna do mezipaměti a absoluteExpiration bude znovu nastavena na DateTime.Now hodnotu obsaženou v parametru slidingExpiration . Pokud položka není požadována z mezipaměti před datem v parametru absoluteExpiration , odebere se z mezipaměti. Položka přidaná do mezipaměti pomocí tohoto přetížení metody insert se vloží s prioritou Default.
