Cache.Insert Metoda

Definice

Obor názvů:: System.Web.Caching

Sestavení:: System.Web.dll

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í

Name	Description
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át, který můžete použít k upozornění aplikace při odebrání vložené položky z objektu `Cache`.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Vloží objekt do objektu Cache spolu 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 Cache závislosti souboru nebo klíče.
Insert(String, Object)	Vloží položku do objektu Cache s klíčem mezipaměti, který odkazuje na jeho umístění, pomocí výchozích hodnot poskytovaných výčtem CacheItemPriority .
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Vloží objekt do Cache závislosti a zásad 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át, který můžete použít k upozornění aplikace při odebrání vložené položky 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, tento parametr obsahuje null.

absoluteExpiration: DateTime

Čas, kdy platnost vloženého objektu vyprší a je odebrána 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 vloženého objektu a časem vypršení platnosti 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 posuvné vypršení platnosti, absoluteExpiration parametr musí být NoAbsoluteExpiration.

priority: CacheItemPriority

Náklady na objekt vzhledem k jiným položkám uloženým v mezipaměti, jak je vyjádřeno výčtem CacheItemPriority . Tato hodnota se používá v mezipaměti při vyřazení 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 v případě poskytnutí volán při odebrání objektu z mezipaměti. Tuto možnost můžete použít k upozorňovat aplikace, když se z mezipaměti odstraní jejich objekty.

Výjimky

ArgumentNullException

Parametr key je valuenull.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na méně než TimeSpan.Zero nebo ekvivalent více než jednoho roku.

ArgumentException

Oba parametry absoluteExpiration jsou nastaveny pro položku, kterou se pokoušíte přidat do objektu slidingExpiration.Cache

Příklady

Následující příklad ukazuje, jak přiřadit položku s vysokou prioritou při vložení do objektu Cache vaší aplikace.

Note

Další informace o tom, jak používat tuto metodu s delegátem CacheItemRemovedCallback , naleznete v tématu Postupy: Oznámit aplikaci 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 stejným key parametrem.

Nemůžete nastavit parametry absoluteExpiration i slidingExpiration parametry. Pokud chcete, aby položka mezipaměti vypršela v určitém čase, nastavíte absoluteExpiration parametr na určitý čas a slidingExpiration parametr na NoSlidingExpirationhodnotu .

Pokud máte v úmyslu položku mezipaměti vypršet 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 spolu 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ý slouží k odkazování na objekt.

value: Object

Objekt, který chcete vložit do mezipaměti.

dependencies: CacheDependency

absoluteExpiration: DateTime

Čas, kdy platnost vloženého objektu vyprší a je odebrána z mezipaměti. Abyste se vyhnuli 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 této hodnoty parametru. Pokud používáte absolutní vypršení platnosti, slidingExpiration parametr musí být nastaven na NoSlidingExpirationhodnotu .

slidingExpiration: TimeSpan

Interval mezi časem posledního přístupu objektu v mezipaměti a časem, kdy platnost objektu 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 posuvné vypršení platnosti, absoluteExpiration parametr musí být nastaven na NoAbsoluteExpirationhodnotu .

onUpdateCallback: CacheItemUpdateCallback

Delegát, který bude volán 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 neodebere z mezipaměti.

Výjimky

ArgumentNullException

Parametr key, valuenebo onUpdateCallback je null.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na méně než TimeSpan.Zero nebo ekvivalent více než jednoho roku.

ArgumentException

Oba parametry absoluteExpiration jsou nastaveny pro položku, kterou se pokoušíte přidat do objektu slidingExpiration.Cache

nebo

Parametr dependencies je nulla absoluteExpiration parametr je nastaven na NoAbsoluteExpirationa slidingExpiration parametr je nastaven na NoSlidingExpiration.

Poznámky

Tato Insert metoda umožňuje vložit novou položku do mezipaměti a poskytnout delegáta, který je volán 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 stejným key parametrem.

Pokud máte v úmyslu položku mezipaměti vypršet po nastaveném časovém období od posledního přístupu k položce, nastavíte slidingExpiration parametr na interval vypršení platnosti a parametr nastavíte absoluteExpiration na NoAbsoluteExpirationhodnotu .

Viz také

CacheItemUpdateCallback

Platí pro

Insert(String, Object, CacheDependency)

Vloží objekt do Cache 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ý 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, tento parametr obsahuje null.

Výjimky

ArgumentNullException

Parametr key je valuenull.

Příklady

Následující příklad ukazuje, jak vložit položku do mezipaměti aplikace s 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 NoSlidingExpirationvypršení platnosti a absolutní hodnotou NoAbsoluteExpirationvypršení platnosti .

Viz také

CacheDependency

Platí pro

Insert(String, Object)

Vloží položku do objektu Cache s klíčem mezipaměti, který odkazuje na jeho umístění, pomocí výchozích hodnot poskytovaný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 je valuenull.

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ávislosti souboru nebo mezipaměti, priorita Default, posunutá hodnota NoSlidingExpirationvypršení platnosti a absolutní hodnota NoAbsoluteExpirationvypršení platnosti .

Viz také

Ukládání dat aplikace do mezipaměti

Platí pro

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

Vloží objekt do Cache závislosti a zásad 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

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Výjimky

ArgumentNullException

Parametr key je valuenull.

ArgumentOutOfRangeException

Parametr nastavíte slidingExpiration na méně než TimeSpan.Zero nebo ekvivalent více než jednoho roku.

ArgumentException

Oba parametry absoluteExpiration jsou nastaveny pro položku, kterou se pokoušíte přidat do objektu slidingExpiration.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.

Note

Vzhledem k tomu, že tato forma metody Insert podporuje závislosti mezipaměti, pokud položka nemá žádné závislosti, je nutné deklarovat parametr dependency jako null (Nothing v 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 stejným key parametrem.

slidingExpiration Pokud je parametr nastaven na NoSlidingExpiration, posuvné vypršení platnosti je zakázáno. Pokud nastavíte slidingExpiration parametr na hodnotu větší než Zero, absoluteExpiration parametr se nastaví na Now plus hodnotu obsaženou v parametru slidingExpiration . Pokud je položka požadována z mezipaměti před dobou určenou parametrem absoluteExpiration , položka se znovu umístí do mezipaměti a absoluteExpiration znovu se nastaví 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 , položka se odebere z mezipaměti. Položka přidaná do mezipaměti pomocí tohoto přetížení metody insert je vložena s prioritou Default.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?