MemoryCache.Set Metod
Definition
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 en cachepost i cacheminnet.
Överlagringar
| Name | Description |
|---|---|
| Set(CacheItem, CacheItemPolicy) |
Infogar en cachepost i cachen med hjälp av en CacheItem instans för att ange nyckeln och värdet för cacheposten. |
| Set(String, Object, DateTimeOffset, String) |
Infogar en cachepost i cachen med hjälp av en nyckel och ett värde och anger tidsbaserad förfalloinformation. |
| Set(String, Object, CacheItemPolicy, String) |
Infogar en cachepost i cachen med hjälp av en nyckel och ett värde och borttagning. |
Kommentarer
Om den angivna posten inte finns skapas den. Om den angivna posten finns uppdateras den.
Set(CacheItem, CacheItemPolicy)
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
Infogar en cachepost i cachen med hjälp av en CacheItem instans för att ange nyckeln och värdet för cacheposten.
public:
override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public override void Set(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unitPublic Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)Parametrar
- item
- CacheItem
Ett objekt som representerar en cachepost som ska infogas.
- policy
- CacheItemPolicy
Ett objekt som innehåller borttagningsinformation för cacheposten. Det här objektet innehåller fler alternativ för borttagning än en enkel absolut förfallotid.
Undantag
En ogiltig kombination av argument för cacheposten skickades. Detta inträffar om följande förfalloinformation anges för principobjektet för cacheposten:
Om både objektets absoluta och glidande förfallovärden CacheItemPolicy är inställda på andra värden än standardvärdena InfiniteAbsoluteExpiration för och NoSlidingExpiration fälten. Klassen MemoryCache kan inte ange förfalloprincip baserat på både en absolut förfallotid och en glidande förfallotid. Endast en förfalloinställning kan anges explicit när du använder MemoryCache klassen. Den andra inställningen måste vara inställd på InfiniteAbsoluteExpiration eller NoSlidingExpiration egenskap.
Om både återanropet för borttagning och återanropet för uppdateringen har angetts för CacheItemPolicy objektet. Klassen MemoryCache stöder endast användning av en typ av återanrop per cachepost.
Egenskapen SlidingExpiration är inställd på ett värde som är mindre än Zero.
-eller-
Egenskapen SlidingExpiration är inställd på ett värde som är större än ett år.
-eller-
Priority är inte ett värde för CacheItemPriority uppräkningen.
Kommentarer
Precis som andra Set metodöverlagringar Set placerar metoden alltid ett cachevärde i cacheminnet, oavsett om det redan finns en post som har samma nyckel. Om den angivna posten inte finns i cacheminnet infogas en ny cachepost. Om den angivna posten redan finns uppdateras dess värde.
Gäller för
Set(String, Object, DateTimeOffset, String)
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
Infogar en cachepost i cachen med hjälp av en nyckel och ett värde och anger tidsbaserad förfalloinformation.
public override void Set(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);override this.Set : string * obj * DateTimeOffset * string -> unitPublic Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)Parametrar
- key
- String
En unik identifierare för cacheposten som ska infogas.
- value
- Object
Data för cacheposten.
- absoluteExpiration
- DateTimeOffset
Det fasta datum och den tid då cacheposten upphör att gälla.
- regionName
- String
En namngiven region i cachen som en cachepost kan läggas till i. Skicka inte ett värde för den här parametern. Den här parametern är null som standard eftersom MemoryCache klassen inte implementerar regioner.
Undantag
regionName är inte null.
En ogiltig kombination av argument för cacheposten skickades. Detta inträffar om följande förfalloinformation anges för principobjektet för cacheposten:
Om både absoluta och glidande förfallovärden för objektet är inställda på CacheItemPolicy andra värden än standardvärdena InfiniteAbsoluteExpiration för och NoSlidingExpiration. Detta beror på att MemoryCache klassen inte stöder förfallna poster baserat på både en absolut och en glidande förfallotid. Endast en förfalloinställning kan anges explicit när du använder MemoryCache klassen. Den andra inställningen måste vara inställd på InfiniteAbsoluteExpiration eller NoSlidingExpiration.
Om både återanropet för borttagning och återanropet för uppdateringen har angetts för CacheItemPolicy objektet. Klassen MemoryCache stöder endast användning av en typ av återanrop per cachepost.
Egenskapen SlidingExpiration är inställd på ett värde som är mindre än Zero.
-eller-
Egenskapen SlidingExpiration är inställd på ett värde som är större än ett år.
-eller-
- Egenskapen Priority är inte ett värde för CacheItemPriority uppräkningen.
Kommentarer
Precis som andra Set metodöverlagringar Set placerar metoden alltid ett cachevärde i cacheminnet, oavsett om en post redan finns med samma nyckel. Om den angivna posten inte finns infogas en ny cachepost. Om den angivna posten finns uppdateras den.
Parametern absoluteExpiration anger när posten ska tas bort från cacheminnet.
Om du tar bort en post utlöses eventuella associerade ändringsövervakare. Om det borttagna objektet var associerat med ett CacheItemUpdateCallback objekt eller CacheItemRemovedCallback objekt finns orsaken till borttagningen som skickas till återanropen Removed i egenskapen.
Gäller för
Set(String, Object, CacheItemPolicy, String)
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
- Källa:
- MemoryCache.cs
Infogar en cachepost i cachen med hjälp av en nyckel och ett värde och borttagning.
public override void Set(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unitPublic Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)Parametrar
- key
- String
En unik identifierare för cacheposten som ska infogas.
- value
- Object
Data för cacheposten.
- policy
- CacheItemPolicy
Ett objekt som innehåller borttagningsinformation för cacheposten. Det här objektet innehåller fler alternativ för borttagning än en enkel absolut förfallotid.
- regionName
- String
En namngiven region i cachen som en cachepost kan läggas till i. Skicka inte ett värde för den här parametern. Den här parametern är null som standard eftersom MemoryCache klassen inte implementerar regioner.
Undantag
key är null.
-eller-
value är null
-eller-
Referensen för återanrop som skickades till hjälpmetoden i egenskapen UpdateCallback är null.
Det finns en ogiltig kombination av argument för cacheposten. Detta inträffar om följande förfalloinformation anges för principobjektet för cacheposten:
Om både absoluta och glidande förfallovärden för objektet är inställda på CacheItemPolicy andra värden än standardvärdena InfiniteAbsoluteExpiration för och NoSlidingExpiration. Det beror på att MemoryCache klassen inte stöder förfallna poster baserat på både en absolut och en glidande förfallotid. Endast en förfalloinställning kan anges explicit när du använder MemoryCache klassen. Den andra inställningen måste vara inställd på InfiniteAbsoluteExpiration eller NoSlidingExpiration.
Om både återanropet för borttagning och återanropet för uppdateringen anges för CacheItemPolicy klassen. Klassen MemoryCache stöder endast användning av en typ av återanrop per cachepost.
Egenskapen SlidingExpiration är inställd på ett värde som är mindre än Zero.
-eller-
Egenskapen SlidingExpiration är inställd på ett värde som är större än ett år.
-eller-
Egenskapen Priority är inte ett värde för CacheItemPriority uppräkningen.
regionName är inte null.
Kommentarer
Precis som andra Set metodöverlagringar Set placerar metoden alltid ett cachevärde i cacheminnet, oavsett om det redan finns en matchande post. Om den angivna posten inte finns i cacheminnet infogas en ny cachepost. Om den angivna posten finns uppdateras den.
Om du tar bort en post utlöses eventuella associerade ändringsövervakare. Om det borttagna objektet var associerat med ett CacheItemUpdateCallback objekt eller CacheItemRemovedCallback objekt finns orsaken till borttagningen som skickas till återanropen Removed i egenskapen.
