MemoryCache.AddOrGetExisting 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 |
|---|---|
| AddOrGetExisting(CacheItem, CacheItemPolicy) |
Voegt een cachevermelding toe aan de cache met behulp van het opgegeven CacheItem exemplaar en details over het verwijderen van de vermelding. |
| AddOrGetExisting(String, Object, DateTimeOffset, String) |
Voegt een cachevermelding toe aan de cache met behulp van de opgegeven sleutel en een waarde en een absolute verloopwaarde. |
| AddOrGetExisting(String, Object, CacheItemPolicy, String) |
Hiermee voegt u een cachevermelding in de cache in met behulp van de opgegeven sleutel en waarde en de opgegeven details voor hoe deze moet worden verwijderd. |
Opmerkingen
De overbelasting van de AddOrGetExisting methode wordt gebruikt om een cachevermelding in de cache in te voegen. Als er geen cachevermelding met een overeenkomende sleutel bestaat, voegen deze methoden een nieuwe vermelding in. Als er al een cachevermelding met een overeenkomende sleutel bestaat, wordt de bestaande vermelding geretourneerd.
AddOrGetExisting(CacheItem, CacheItemPolicy)
Voegt een cachevermelding toe aan de cache met behulp van het opgegeven CacheItem exemplaar en details over het verwijderen van de vermelding.
public:
override System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public override System.Runtime.Caching.CacheItem AddOrGetExisting(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);override this.AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItemPublic Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItemParameters
- item
- CacheItem
Het object dat moet worden toegevoegd.
- policy
- CacheItemPolicy
Een object met verwijderingsgegevens voor de cachevermelding. Dit object biedt meer opties voor verwijdering dan een eenvoudige absolute vervaldatum.
Retouren
Als er een cachevermelding met dezelfde sleutel bestaat, bestaat de bestaande cachevermelding; anders, null.
Uitzonderingen
De eigenschap Value is null.
Zowel de absolute als de schuifverloopwaarden voor 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 een combinatie van een absolute vervaldatum en een schuifverlooptijd. Er kan slechts één verloopinstelling expliciet worden ingesteld wanneer u het MemoryCache exemplaar gebruikt. De andere verloopinstelling moet worden ingesteld op InfiniteAbsoluteExpiration veld of NoSlidingExpiration veld.
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
De item parameter levert de sleutel en de waarde die door de methode wordt gebruikt. Als de cache een cachevermelding heeft met dezelfde sleutel als de sleutel van de item parameter, retourneert de methode de bestaande vermelding als een CacheItem exemplaar. Als er geen bestaande cachevermelding is, maakt de methode een nieuwe met behulp van de sleutel en waarde die is opgegeven door de item parameter, en met de verwijderingsgegevens die zijn opgegeven door policy.
Waarschuwing
De Add en AddOrGetExisting methode-overbelastingen bieden geen ondersteuning voor de UpdateCallback eigenschap. Als u de UpdateCallback eigenschap voor een cachevermelding wilt instellen, gebruikt u in plaats daarvan de overbelasting van de Set methode.
Van toepassing op
AddOrGetExisting(String, Object, DateTimeOffset, String)
Voegt een cachevermelding toe aan de cache met behulp van de opgegeven sleutel en een waarde en een absolute verloopwaarde.
public override object AddOrGetExisting(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> objPublic Overrides Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As ObjectParameters
- key
- String
Een unieke id voor de cachevermelding die moet worden toegevoegd.
- 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.
Retouren
Als er een cachevermelding met dezelfde sleutel bestaat, bestaat de bestaande cachevermelding; anders, null.
Uitzonderingen
value is niet null.
regionName is niet null.
Zowel de absolute als de schuifverloopwaarden voor 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 een combinatie van een absolute vervaldatum en een schuifverlooptijd. Er kan slechts één verloopinstelling expliciet worden ingesteld wanneer u het MemoryCache exemplaar gebruikt. De andere verloopinstelling moet worden ingesteld op InfiniteAbsoluteExpiration of NoSlidingExpiration
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
Als de cache geen cachevermelding heeft waarvan de sleutel overeenkomt met de key parameter, wordt er een nieuwe cachevermelding gemaakt en wordt de overbelasting van nullde MemoryCache.AddOrGetExisting methode geretourneerd. Als er een overeenkomende cachevermelding bestaat, wordt de bestaande vermelding geretourneerd.
Waarschuwing
De Add en AddOrGetExisting methode-overbelastingen bieden geen ondersteuning voor de UpdateCallback eigenschap. Als u de UpdateCallback eigenschap voor een cachevermelding wilt instellen, gebruikt u in plaats daarvan de overbelasting van de Set methode.
Van toepassing op
AddOrGetExisting(String, Object, CacheItemPolicy, String)
Hiermee voegt u een cachevermelding in de cache in met behulp van de opgegeven sleutel en waarde en de opgegeven details voor hoe deze moet worden verwijderd.
public override object AddOrGetExisting(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);override this.AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> objPublic Overrides Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As ObjectParameters
- key
- String
Een unieke id voor de cachevermelding die moet worden toegevoegd of get.
- 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 nullstandaard, omdat de MemoryCache klasse geen regio's implementeert.
Retouren
Als er al een overeenkomende cachevermelding bestaat, wordt er een cachevermelding weergegeven; anders, null.
Uitzonderingen
value is null.
Zowel de absolute als de schuifverloopwaarden van CacheItemPolicy het object zijn ingesteld op andere waarden dan de standaardwaarden van InfiniteAbsoluteExpiration en NoSlidingExpiration. De MemoryCache klasse kan het verloopbeleid niet instellen op basis van een combinatie van zowel een absolute 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.
– of –
Zowel de callback voor het verwijderen als de callback van de update zijn opgegeven voor CacheItemPolicy. De MemoryCache enige ondersteuning voor het gebruik van één type callback per cachevermelding.
De SlidingExpiration eigenschap is ingesteld op een waarde kleiner dan Zero.
– of –
De SlidingExpiration waarde is ingesteld op een waarde van meer dan één jaar.
– of –
De Priority eigenschap is geen waarde van de CacheItemPriority opsomming.
Opmerkingen
Waarschuwing
De Add en AddOrGetExisting methode-overbelastingen bieden geen ondersteuning voor de UpdateCallback eigenschap. Als u de UpdateCallback eigenschap voor een cachevermelding wilt instellen, gebruikt u in plaats daarvan de overbelasting van de Set methode.