ObjectCache.Add 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.
Wanneer deze wordt overschreven in een afgeleide klasse, voegt u een cachevermelding in de cache in, zonder dat een bestaande cachevermelding met een overeenkomende sleutel moet worden geretourneerd.
Overloads
| Name | Description |
|---|---|
| Add(CacheItem, CacheItemPolicy) |
Wanneer deze wordt overschreven in een afgeleide klasse, probeert u een cachevermelding in te voegen in de cache als een CacheItem exemplaar en voegt u details toe over hoe de vermelding moet worden verwijderd. |
| Add(String, Object, DateTimeOffset, String) |
Wanneer deze wordt overschreven in een afgeleide klasse, voegt u een cachevermelding in de cache in zonder een bestaande cachevermelding te overschrijven. |
| Add(String, Object, CacheItemPolicy, String) |
Wanneer deze wordt overschreven in een afgeleide klasse, voegt u een cachevermelding in de cache in en geeft u informatie op over hoe de vermelding wordt verwijderd. |
Opmerkingen
De Add methode overbelasting probeert een cachevermelding in te voegen in de cache, zonder een bestaande cachevermelding met dezelfde sleutel te overschrijven of te verwijderen. De cachevermelding kan een getypt CacheItem object of een algemeen object zijn.
De AddOrGetExisting overbelasting van de methode en de overbelasting van de Add methode hebben één belangrijk verschil. Wanneer deze methoden een cachevermelding invoegen, als er een overeenkomende vermelding in de cache wordt gevonden, retourneert de AddOrGetExisting methode overbelast de bestaande cachevermelding, maar de overbelasting van de Add methode niet. Door deze verschillende methodeoverbelastingen te hebben, kunnen bellers hun code optimaliseren op basis van of ze de bestaande cachevermelding nodig hebben. In gedistribueerde caches kan het retourneren van een bestaande waarde met behulp van de AddOrGetExisting methode duurder zijn dan het retourneren van een Booleaanse waarde met behulp van de Add methode.
Add(CacheItem, CacheItemPolicy)
Wanneer deze wordt overschreven in een afgeleide klasse, probeert u een cachevermelding in te voegen in de cache als een CacheItem exemplaar en voegt u details toe over hoe de vermelding moet worden verwijderd.
public:
virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public virtual bool Add(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As BooleanParameters
- 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
true als het invoegen is geslaagd of false als er al een vermelding in de cache is die dezelfde sleutel heeft als item.
Opmerkingen
De overbelasting van de Add methode is virtueel (niet abstract) voor de ObjectCache klasse, omdat de Add methode intern aanroept AddOrGetExisting. Dit vermindert het aantal overbelastingen van methoden dat een cache-implementeerfunctie moet bieden. Als een cache-implementatie geen speciaal gedrag voor de Add methode vereist, kan deze alleen de overbelasting van de AddOrGetExisting methode implementeren.
Van toepassing op
Add(String, Object, DateTimeOffset, String)
Wanneer deze wordt overschreven in een afgeleide klasse, voegt u een cachevermelding in de cache in zonder een bestaande cachevermelding te overschrijven.
public virtual bool Add(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> boolPublic Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As BooleanParameters
- key
- String
Een unieke id voor de cachevermelding.
- value
- Object
Het object dat moet worden ingevoegd.
- absoluteExpiration
- DateTimeOffset
De vaste datum en tijd waarop de cachevermelding verloopt. Deze parameter is vereist wanneer de Add methode wordt aangeroepen.
- regionName
- String
Optional. Een benoemde regio in de cache waaraan de cachevermelding kan worden toegevoegd als regio's worden geïmplementeerd. Omdat regio's niet zijn geïmplementeerd in .NET Framework 4, is de standaardwaarde null.
Retouren
true als het invoegen is geslaagd of false als er al een vermelding in de cache is die dezelfde sleutel heeft als key.
Opmerkingen
De overbelasting van de Add methode is virtueel (niet abstract) voor de ObjectCache klasse, omdat de Add methode intern aanroept AddOrGetExisting. Dit vermindert het aantal overbelastingen van methoden dat een cache-implementeerfunctie moet bieden. Als een cache-implementatie geen speciaal gedrag voor de Add methode vereist, kan deze alleen de overbelasting van de AddOrGetExisting methode implementeren.
Van toepassing op
Add(String, Object, CacheItemPolicy, String)
Wanneer deze wordt overschreven in een afgeleide klasse, voegt u een cachevermelding in de cache in en geeft u informatie op over hoe de vermelding wordt verwijderd.
public virtual bool Add(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> boolPublic Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As BooleanParameters
- key
- String
Een unieke id voor de cachevermelding.
- value
- Object
Het object dat moet worden ingevoegd.
- policy
- CacheItemPolicy
Een object met verwijderingsgegevens voor de cachevermelding. Dit object biedt meer opties voor verwijdering dan een eenvoudige absolute vervaldatum.
- regionName
- String
Optional. Een benoemde regio in de cache waaraan de cachevermelding kan worden toegevoegd als regio's worden geïmplementeerd. De standaardwaarde voor de optionele parameter is null.
Retouren
true als de invoegbewerking slaagt of false als er al een vermelding in de cache is met dezelfde sleutel als key.
Opmerkingen
De overbelasting van de Add methode is virtueel (niet abstract) voor de ObjectCache klasse, omdat de Add methode intern aanroept AddOrGetExisting. Dit vermindert het aantal overbelastingen van methoden dat een cache-implementeerfunctie moet bieden. Als een cache-implementatie geen speciaal gedrag voor de Add methode vereist, kan deze alleen de overbelasting van de AddOrGetExisting methode implementeren.