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 |
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 souboru nebo klíče. |
Insert(String, Object) |
Vloží položku do objektu Cache s klíčem mezipaměti odkazovat na jeho umístění pomocí výchozích hodnot zadaných výčtem 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 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 -> 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)
Parametry
- key
- String
Klíč mezipaměti použitý k odkazování na objekt.
- value
- Object
Objekt, který má být vložen 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 například změny ze standardního času na letní čas, použijte UtcNow pro tuto hodnotu parametru místo Now . 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 tato hodnota odpovídá 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
Cena objektu vzhledem k ostatním položkám uloženým v mezipaměti vyjádřená výčtem CacheItemPriority . Tato hodnota se používá v mezipaměti 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ý, pokud je k dispozici, bude volána při odebrání objektu z mezipaměti. 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 menší 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 CacheItemRemovedCallback naleznete v 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.
Nelze nastavit parametry i absoluteExpiration
slidingExpiration
. 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 určité době od posledního přístupu k položce, nastavte 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 -> unit
Public 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. Abyste se vyhnuli možným problémům s místním časem, jako jsou například změny ze standardního času na letní čas, použijte UtcNow pro tuto hodnotu parametru Now místo . 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 tato hodnota odpovídá 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 v mezipaměti a zajistit, aby nebyla odebrána z mezipaměti.
Výjimky
Parametr key
, value
nebo onUpdateCallback
je null
.
Parametr nastavíte slidingExpiration
na hodnotu menší 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 a parametr absoluteExpiration
je nastavený na NoAbsoluteExpirationa slidingExpiration
parametr je nastavený na NoSlidingExpirationhodnotu .null
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.
Nelze nastavit parametry i absoluteExpiration
slidingExpiration
. 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í nastaveného časového období od posledního přístupu k položce, nastavte 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 souboru nebo klíče.
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)
Parametry
- key
- String
Klíč mezipaměti použitý k identifikaci položky.
- value
- Object
Objekt, který má být vložen 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 se vloží s prioritou Default, posuvnou hodnotou vypršení platnosti a NoSlidingExpirationabsolutní hodnotou vypršení platnosti .NoAbsoluteExpiration
Viz také
Platí pro
Insert(String, Object)
Vloží položku do objektu Cache s klíčem mezipaměti odkazovat na jeho umístění pomocí výchozích hodnot zadaných výčtem CacheItemPriority .
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)
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í na souborech nebo mezipamětí, prioritě Default, klouzavé hodnoty vypršení platnosti a NoSlidingExpirationabsolutní hodnoty 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 -> unit
Public 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ý má být vložen 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. Pokud se chcete vyhnout možným problémům s místním časem, jako jsou například změny ze standardního času na letní čas, použijte UtcNow pro tuto hodnotu parametru místo Now . 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 menší 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 posuvný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.
Viz také
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro