Cache.Insert Metoda

Definice

Obor názvů:

System.Web.Caching

Sestavení:

System.Web.dll

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 Cache.
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

ArgumentNullException

Parametr key nebo value je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na hodnotu menší než TimeSpan.Zero nebo ekvivalent více než jeden rok.

ArgumentException

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 absoluteExpirationslidingExpiration . 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é

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Ukládání aplikačních dat do mezipaměti

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

ArgumentNullException

Parametr key, valuenebo onUpdateCallback je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na hodnotu menší než TimeSpan.Zero nebo ekvivalent více než jeden rok.

ArgumentException

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 absoluteExpirationslidingExpiration . 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é

• CacheItemUpdateCallback

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

ArgumentNullException

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é

• CacheDependency

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

ArgumentNullException

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é

• Ukládání aplikačních dat do mezipaměti

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

ArgumentNullException

Parametr key nebo value je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na hodnotu menší než TimeSpan.Zero nebo ekvivalent více než jeden rok.

ArgumentException

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é

• DateTime
• TimeSpan
• Ukládání dat aplikací do mezipaměti