Cache.Insert Metod

Definition

Namnområde:: System.Web.Caching

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Infogar ett objekt i objektet Cache . Använd en av versionerna av den här metoden för att skriva över ett befintligt Cache objekt med samma key parameter.

Överlagringar

Name	Description
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Infogar ett objekt i Cache objektet med beroenden, principer för förfallodatum och prioritet samt ett ombud som du kan använda för att meddela ditt program när det infogade objektet tas bort från `Cache`.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Infogar ett objekt i Cache objektet tillsammans med beroenden, förfalloprinciper och ett ombud som du kan använda för att meddela programmet innan objektet tas bort från cacheminnet.
Insert(String, Object, CacheDependency)	Infogar ett objekt i Cache som har fil- eller nyckelberoenden.
Insert(String, Object)	Infogar ett objekt i Cache objektet med en cachenyckel för att referera till dess plats, med hjälp av standardvärden som tillhandahålls av CacheItemPriority uppräkningen.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Infogar ett objekt i Cache med beroenden och förfalloprinciper.

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

Infogar ett objekt i Cache objektet med beroenden, principer för förfallodatum och prioritet samt ett ombud som du kan använda för att meddela ditt program när det infogade objektet tas bort från 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)

Parametrar

key: String

Cachenyckeln som används för att referera till objektet.

value: Object

Objektet som ska infogas i cacheminnet.

dependencies: CacheDependency

Fil- eller cachenyckelberoenden för objektet. När eventuella beroenden ändras blir objektet ogiltigt och tas bort från cacheminnet. Om det inte finns några beroenden innehåller nullden här parametern .

absoluteExpiration: DateTime

Tiden då det infogade objektet upphör att gälla och tas bort från cacheminnet. För att undvika eventuella problem med lokal tid, till exempel ändringar från standardtid till sommartid, använder du UtcNow i stället Now för för det här parametervärdet. Om du använder absolut förfallodatum måste parametern slidingExpiration vara NoSlidingExpiration.

slidingExpiration: TimeSpan

Intervallet mellan den tid då det infogade objektet senast användes och den tidpunkt då objektet upphör att gälla. Om det här värdet motsvarar 20 minuter upphör objektet att gälla och tas bort från cachen 20 minuter efter att det senast användes. Om du använder glidande förfallodatum måste parametern absoluteExpiration vara NoAbsoluteExpiration.

priority: CacheItemPriority

Kostnaden för objektet i förhållande till andra objekt som lagras i cacheminnet, vilket uttrycks av CacheItemPriority uppräkningen. Det här värdet används av cacheminnet när det avlägsnar objekt. objekt med lägre kostnad tas bort från cachen innan objekt med högre kostnad.

onRemoveCallback: CacheItemRemovedCallback

Ett ombud som, om det tillhandahålls, anropas när ett objekt tas bort från cacheminnet. Du kan använda detta för att meddela program när deras objekt tas bort från cacheminnet.

Undantag

ArgumentNullException

Parametern key eller value är null.

ArgumentOutOfRangeException

Du anger parametern slidingExpiration till mindre än TimeSpan.Zero eller motsvarande mer än ett år.

ArgumentException

Parametrarna absoluteExpiration och slidingExpiration anges båda för det objekt som du försöker lägga till i Cache.

Exempel

I följande exempel visas hur du tilldelar ett objekt hög prioritet när du infogar det i programmets Cache objekt.

Note

Mer information om hur du använder den här metoden med ombudet CacheItemRemovedCallback finns i Så här: Meddela ett program när ett objekt tas bort från cachen.

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)

Kommentarer

Den här metoden skriver över ett befintligt Cache objekt med samma key parameter.

Du kan inte ange både parametrarna absoluteExpiration och slidingExpiration . Om du tänker att cacheobjektet ska upphöra att gälla vid en viss tidpunkt anger du parametern absoluteExpiration till den specifika tiden och parametern slidingExpiration till NoSlidingExpiration.

Om du tänker att cacheobjektet ska upphöra att gälla efter att en viss tid har passerat sedan den senaste åtkomsten till objektet anger slidingExpiration du parametern till förfallointervallet och parametern absoluteExpiration till NoAbsoluteExpiration.

Se även

Gäller för

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

Infogar ett objekt i Cache objektet tillsammans med beroenden, förfalloprinciper och ett ombud som du kan använda för att meddela programmet innan objektet tas bort från cacheminnet.

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)

Parametrar

key: String

Cachenyckeln som används för att referera till objektet.

value: Object

Objektet som ska infogas i cacheminnet.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Intervallet mellan den tid då det cachelagrade objektet senast användes och den tidpunkt då objektet upphör att gälla. Om det här värdet motsvarar 20 minuter upphör objektet att gälla och tas bort från cachen 20 minuter efter att det senast användes. Om du använder glidande förfallotid måste parametern absoluteExpiration vara inställd på NoAbsoluteExpiration.

onUpdateCallback: CacheItemUpdateCallback

Ett ombud som anropas innan objektet tas bort från cacheminnet. Du kan använda detta för att uppdatera det cachelagrade objektet och se till att det inte tas bort från cacheminnet.

Undantag

ArgumentNullException

Parametern key, valueeller onUpdateCallback är null.

ArgumentOutOfRangeException

Du anger parametern slidingExpiration till mindre än TimeSpan.Zero eller motsvarande mer än ett år.

ArgumentException

Parametrarna absoluteExpiration och slidingExpiration anges båda för det objekt som du försöker lägga till i Cache.

-eller-

Parametern dependencies är null, och parametern absoluteExpiration är inställd på NoAbsoluteExpiration, och parametern slidingExpiration är inställd på NoSlidingExpiration.

Kommentarer

Med Insert metoden kan du infoga ett nytt objekt i cacheminnet och ange ett ombud som anropas innan objektet tas bort från cacheminnet. I ombudet kan du uppdatera det cachelagrade objektet och därmed förhindra att det tas bort från cacheminnet.

Den här metoden skriver över ett befintligt Cache objekt med samma key parameter.

Om du tänker att cacheobjektet ska upphöra att gälla efter en angiven tidsperiod sedan objektet senast användes anger du parametern slidingExpiration till förfallointervallet och anger parametern absoluteExpiration till NoAbsoluteExpiration.

Se även

CacheItemUpdateCallback

Gäller för

Insert(String, Object, CacheDependency)

Infogar ett objekt i Cache som har fil- eller nyckelberoenden.

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)

Parametrar

key: String

Cachenyckeln som används för att identifiera objektet.

value: Object

Objektet som ska infogas i cacheminnet.

dependencies: CacheDependency

Fil- eller cachenyckelberoenden för det infogade objektet. När eventuella beroenden ändras blir objektet ogiltigt och tas bort från cacheminnet. Om det inte finns några beroenden innehåller nullden här parametern .

Undantag

ArgumentNullException

Parametern key eller value är null.

Exempel

I följande exempel visas hur du infogar ett objekt i ett programs cacheminne med ett cacheberoende för en XML-konfigurationsfil.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

Kommentarer

Den här metoden skriver över ett befintligt cacheobjekt vars nyckel matchar parametern key . Objektet som läggs till i cachen med den här överlagringen av metoden infogas med prioriteten InsertDefault, ett glidande förfallovärde på NoSlidingExpirationoch ett absolut förfallovärde på NoAbsoluteExpiration.

Se även

CacheDependency

Gäller för

Insert(String, Object)

Infogar ett objekt i Cache objektet med en cachenyckel för att referera till dess plats, med hjälp av standardvärden som tillhandahålls av CacheItemPriority uppräkningen.

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)

Parametrar

key: String

Cachenyckeln som används för att referera till objektet.

value: Object

Objektet som ska infogas i cacheminnet.

Undantag

ArgumentNullException

Parametern key eller value är null.

Exempel

I följande exempel visas hur du infogar ett objekt i ett programs cacheminne.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Kommentarer

Den här metoden skriver över ett befintligt cacheobjekt vars nyckel matchar parametern key . Objektet som läggs till i cachen med den här överlagringen Insert av metoden infogas utan fil- eller cacheberoenden, en prioritet på Default, ett glidande förfallovärde för NoSlidingExpirationoch ett absolut förfallovärde på NoAbsoluteExpiration.

Se även

Cachelagring av programdata

Gäller för

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

Infogar ett objekt i Cache med beroenden och förfalloprinciper.

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)

Parametrar

key: String

Cachenyckeln som används för att referera till objektet.

value: Object

Objektet som ska infogas i cacheminnet.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Intervallet mellan den tid då det infogade objektet senast används och tiden då objektet upphör att gälla. Om det här värdet motsvarar 20 minuter upphör objektet att gälla och tas bort från cachen 20 minuter efter att det senast användes. Om du använder glidande förfallodatum måste parametern absoluteExpiration vara NoAbsoluteExpiration.

Undantag

ArgumentNullException

Parametern key eller value är null.

ArgumentOutOfRangeException

Du anger parametern slidingExpiration till mindre än TimeSpan.Zero eller motsvarande mer än ett år.

ArgumentException

Parametrarna absoluteExpiration och slidingExpiration anges båda för det objekt som du försöker lägga till i Cache.

Exempel

I följande exempel visas hur du infogar ett objekt i ett programs cacheminne med en absolut förfallotid.

Note

Eftersom den här formen av metoden Insert stöder cacheberoenden måste du deklarera parametern dependency som null (Nothing i Visual Basic) i den kommaavgränsade listan med parametrar.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

I följande exempel visas hur du infogar ett objekt i cacheminnet med en glidande förfallotid.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));

Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

Kommentarer

Den här metoden skriver över ett befintligt Cache objekt med samma key parameter.

Om parametern slidingExpiration är inställd på NoSlidingExpirationinaktiveras glidande förfallotid. Om du anger parametern slidingExpiration till större än Zeroanges parametern absoluteExpiration till Now plus värdet i parametern slidingExpiration . Om objektet begärs från cacheminnet före den tid som anges av parametern absoluteExpiration placeras objektet i cacheminnet igen och absoluteExpiration anges igen till DateTime.Now plus värdet i parametern slidingExpiration . Om objektet inte begärs från cachen före datumet i parametern absoluteExpiration tas objektet bort från cacheminnet. Objektet som läggs till i cacheminnet med den här överlagringen av insert-metoden infogas med prioriteten Default.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?