MemoryCache.Set Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een cachevermelding in de cache in.
Overloads
| Name | Description |
|---|---|
| Set(CacheItem, CacheItemPolicy) |
Hiermee voegt u een cachevermelding in de cache in met behulp van een CacheItem exemplaar om de sleutel en waarde voor de cachevermelding op te geven. |
| Set(String, Object, DateTimeOffset, String) |
Hiermee voegt u een cachevermelding in de cache in met behulp van een sleutel en een waarde en geeft u verloopgegevens op basis van tijd op. |
| Set(String, Object, CacheItemPolicy, String) |
Hiermee voegt u een cachevermelding in de cache in met behulp van een sleutel en een waarde en verwijdering. |
Opmerkingen
Als de opgegeven vermelding niet bestaat, wordt deze gemaakt. Als de opgegeven vermelding bestaat, wordt deze bijgewerkt.
Set(CacheItem, CacheItemPolicy)
Hiermee voegt u een cachevermelding in de cache in met behulp van een CacheItem exemplaar om de sleutel en waarde voor de cachevermelding op te geven.
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)Parameters
- item
- CacheItem
Een object dat een cachevermelding vertegenwoordigt die moet worden ingevoegd.
- policy
- CacheItemPolicy
Een object met verwijderingsgegevens voor de cachevermelding. Dit object biedt meer opties voor verwijdering dan een eenvoudige absolute vervaldatum.
Uitzonderingen
Er is een ongeldige combinatie van argumenten voor de cachevermelding doorgegeven. Dit gebeurt als de volgende verloopdetails zijn ingesteld op het beleidsobject voor de cachevermelding:
Als zowel de absolute als de schuifverloopwaarden van het CacheItemPolicy object zijn ingesteld op andere waarden dan de standaardwaarden van InfiniteAbsoluteExpiration en NoSlidingExpiration velden. De MemoryCache klasse kan geen verloopbeleid instellen op basis van zowel een absolute vervaldatum als een schuifverlooptijd. Er kan slechts één verloopinstelling expliciet worden ingesteld wanneer u de MemoryCache klasse gebruikt. De andere instelling moet worden ingesteld op InfiniteAbsoluteExpiration of NoSlidingExpiration eigenschap.
Als zowel de callback voor verwijdering als de update-callback zijn opgegeven voor CacheItemPolicy object. De MemoryCache klasse biedt alleen ondersteuning voor het gebruik van één type callback per cachevermelding.
De SlidingExpiration eigenschap is ingesteld op een waarde kleiner dan Zero.
– of –
De SlidingExpiration eigenschap is ingesteld op een waarde van meer dan één jaar.
– of –
Het Priority is geen waarde van de CacheItemPriority opsomming.
Opmerkingen
Net als bij andere Set overbelastingen van methoden plaatst de Set methode altijd een cachewaarde in de cache, ongeacht of er al een vermelding bestaat die dezelfde sleutel heeft. Als de opgegeven vermelding niet in de cache bestaat, wordt er een nieuwe cachevermelding ingevoegd. Als de opgegeven vermelding al bestaat, wordt de waarde ervan bijgewerkt.
Van toepassing op
Set(String, Object, DateTimeOffset, String)
Hiermee voegt u een cachevermelding in de cache in met behulp van een sleutel en een waarde en geeft u verloopgegevens op basis van tijd op.
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)Parameters
- key
- String
Een unieke id voor de cachevermelding die moet worden ingevoegd.
- value
- Object
De gegevens voor de cachevermelding.
- absoluteExpiration
- DateTimeOffset
De vaste datum en tijd waarop de cachevermelding verloopt.
- regionName
- String
Een benoemde regio in de cache waaraan een cachevermelding kan worden toegevoegd. Geef geen waarde door voor deze parameter. Deze parameter is null standaard omdat de MemoryCache klasse geen regio's implementeert.
Uitzonderingen
regionName is niet null.
Er is een ongeldige combinatie van argumenten voor de cachevermelding doorgegeven. Dit gebeurt als de volgende verloopdetails zijn ingesteld op het beleidsobject voor de cachevermelding:
Als zowel de absolute als de schuifverloopwaarden voor het object zijn ingesteld op CacheItemPolicy andere waarden dan de standaardwaarden van InfiniteAbsoluteExpiration en NoSlidingExpiration. Dit komt doordat de MemoryCache klasse geen ondersteuning biedt voor verlopende vermeldingen op basis van zowel een absolute als een verschuivende vervaldatum. Er kan slechts één verloopinstelling expliciet worden ingesteld wanneer u de MemoryCache klasse gebruikt. De andere instelling moet worden ingesteld op InfiniteAbsoluteExpiration of NoSlidingExpiration.
Als zowel de callback voor het verwijderen als de update-callback zijn opgegeven voor CacheItemPolicy het object. De MemoryCache klasse biedt alleen ondersteuning voor het gebruik van één type callback per cachevermelding.
De SlidingExpiration eigenschap is ingesteld op een waarde kleiner dan Zero.
– of –
De SlidingExpiration eigenschap is ingesteld op een waarde van meer dan één jaar.
– of –
- De Priority eigenschap is geen waarde van de CacheItemPriority opsomming.
Opmerkingen
Net als bij andere Set overbelasting van methoden plaatst de Set methode altijd een cachewaarde in de cache, ongeacht of er al een vermelding met dezelfde sleutel bestaat. Als de opgegeven vermelding niet bestaat, wordt er een nieuwe cachevermelding ingevoegd. Als de opgegeven vermelding bestaat, wordt deze bijgewerkt.
De absoluteExpiration parameter geeft aan wanneer de vermelding uit de cache moet worden verwijderd.
Als u een item verwijdert, worden alle gekoppelde wijzigingsmonitors geactiveerd. Als het verwijderde item is gekoppeld aan een CacheItemUpdateCallback object of CacheItemRemovedCallback object, is de reden voor verwijdering die wordt doorgegeven aan de callbacks in de Removed eigenschap.
Van toepassing op
Set(String, Object, CacheItemPolicy, String)
Hiermee voegt u een cachevermelding in de cache in met behulp van een sleutel en een waarde en verwijdering.
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)Parameters
- key
- String
Een unieke id voor de cachevermelding die moet worden ingevoegd.
- value
- Object
De gegevens voor de cachevermelding.
- policy
- CacheItemPolicy
Een object met verwijderingsgegevens voor de cachevermelding. Dit object biedt meer opties voor verwijdering dan een eenvoudige absolute vervaldatum.
- regionName
- String
Een benoemde regio in de cache waaraan een cachevermelding kan worden toegevoegd. Geef geen waarde door voor deze parameter. Deze parameter is null standaard omdat de MemoryCache klasse geen regio's implementeert.
Uitzonderingen
key is null.
– of –
value Is null
– of –
De callback-verwijzing die is doorgegeven aan de helpermethode in de UpdateCallback eigenschap is null.
Er bestaat een ongeldige combinatie van argumenten voor de cachevermelding. Dit gebeurt als de volgende verloopdetails zijn ingesteld op het beleidsobject voor de cachevermelding:
Als zowel de absolute als de schuifverloopwaarden voor het object zijn ingesteld op CacheItemPolicy andere waarden dan de standaardwaarden van InfiniteAbsoluteExpiration en NoSlidingExpiration. Dit komt doordat de MemoryCache klasse geen ondersteuning biedt voor verlopende vermeldingen op basis van zowel een absolute als een verschuivende vervaldatum. Er kan slechts één verloopinstelling expliciet worden ingesteld wanneer u de MemoryCache klasse gebruikt. De andere instelling moet worden ingesteld op InfiniteAbsoluteExpiration of NoSlidingExpiration.
Als zowel de callback voor verwijdering als de update-callback zijn opgegeven in CacheItemPolicy klasse. De MemoryCache klasse biedt alleen ondersteuning voor het gebruik van één type callback per cachevermelding.
De SlidingExpiration eigenschap is ingesteld op een waarde kleiner dan Zero.
– of –
De SlidingExpiration eigenschap is ingesteld op een waarde van meer dan één jaar.
– of –
De Priority eigenschap is geen waarde van de CacheItemPriority opsomming.
regionName is niet null.
Opmerkingen
Net als bij andere Set overbelasting van methoden plaatst de Set methode altijd een cachewaarde in de cache, ongeacht of er al een overeenkomende vermelding bestaat. Als de opgegeven vermelding niet in de cache bestaat, wordt er een nieuwe cachevermelding ingevoegd. Als de opgegeven vermelding bestaat, wordt deze bijgewerkt.
Als u een item verwijdert, worden alle gekoppelde wijzigingsmonitors geactiveerd. Als het verwijderde item is gekoppeld aan een CacheItemUpdateCallback object of CacheItemRemovedCallback object, is de reden voor verwijdering die wordt doorgegeven aan de callbacks in de Removed eigenschap.