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 objektu 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 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 -> 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ý 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

ArgumentNullException

Parametr key nebo value je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na hodnotu kratší 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 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é

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Ukládání dat aplikací 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. 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

ArgumentNullException

Parametr key, valuenebo onUpdateCallback je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na hodnotu kratší 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 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é

• CacheItemUpdateCallback

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 -> 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ý 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

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 je vložen s prioritou Default, posunutou hodnotou NoSlidingExpirationvypršení platnosti , a absolutní hodnotou vypršení platnosti .NoAbsoluteExpiration

Viz také

• CacheDependency

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 -> 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í souborů nebo mezipaměti, priority Default, posunutá hodnota NoSlidingExpirationvypršení platnosti , a absolutní hodnota vypršení platnosti .NoAbsoluteExpiration

Viz také

• Ukládání dat aplikací 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ý 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

ArgumentNullException

Parametr key nebo value je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na hodnotu kratší 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 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.

Viz také

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