Cache.Add Methode

Definitie

Naamruimte:
System.Web.Caching
Assembly:
System.Web.dll

Voegt het opgegeven item toe aan het object met afhankelijkheden, verloop- en prioriteitsbeleid en een gemachtigde die u kunt gebruiken om uw toepassing op de Cache hoogte te stellen wanneer het ingevoegde item wordt verwijderd uit het Cache.

public:
 System::Object ^ Add(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 object Add(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.Add : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> obj
Public Function Add (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback) As Object

Parameters

key
String

De cachesleutel die wordt gebruikt om naar het item te verwijzen.

value
Object

Het item dat moet worden toegevoegd aan de cache.

dependencies
CacheDependency

De afhankelijkheden van de bestands- of cachesleutel voor het item. Wanneer een afhankelijkheid verandert, wordt het object ongeldig en wordt het verwijderd uit de cache. Als er geen afhankelijkheden zijn, bevat nulldeze parameter .

absoluteExpiration
DateTime

Het tijdstip waarop het toegevoegde object verloopt en wordt verwijderd uit de cache. Als u een schuifverlooptijd gebruikt, moet de absoluteExpiration parameter zijn NoAbsoluteExpiration.

slidingExpiration
TimeSpan

Het interval tussen het tijdstip waarop het toegevoegde object voor het laatst is geopend en het tijdstip waarop dat object verloopt. Als deze waarde het equivalent is van 20 minuten, verloopt het object en wordt het 20 minuten nadat het object voor het laatst is geopend uit de cache verwijderd. Als u absolute vervaldatum gebruikt, moet de slidingExpiration parameter zijn NoSlidingExpiration.

priority
CacheItemPriority

De relatieve kosten van het object, uitgedrukt in de CacheItemPriority opsomming. De cache gebruikt deze waarde wanneer objecten worden verwijderd; objecten met een lagere kosten worden verwijderd uit de cache voordat objecten met een hogere kosten.

onRemoveCallback
CacheItemRemovedCallback

Een gemachtigde die, indien opgegeven, wordt aangeroepen wanneer een object uit de cache wordt verwijderd. U kunt dit gebruiken om toepassingen op de hoogte te stellen wanneer hun objecten uit de cache worden verwijderd.

Retouren

Object

Een object dat het item vertegenwoordigt dat is toegevoegd als het item eerder in de cache is opgeslagen; anders, null.

Uitzonderingen

ArgumentNullException

De key of value parameter is ingesteld op null.

ArgumentOutOfRangeException

De slidingExpiration parameter is ingesteld op minder dan TimeSpan.Zero of meer dan één jaar.

ArgumentException

De absoluteExpiration parameters slidingExpiration zijn beide ingesteld voor het item dat u probeert toe te voegen aan het Cache.

Voorbeelden

In het volgende voorbeeld wordt een AddItemToCache methode gemaakt. Wanneer deze methode wordt aangeroepen, wordt een itemRemoved eigenschap ingesteld false op en wordt een onRemove methode geregistreerd bij een nieuw exemplaar van de CacheItemRemovedCallback gemachtigde. De handtekening van de gemachtigde wordt gebruikt in de RemovedCallback methode. De AddItemToCache methode controleert vervolgens de waarde die is gekoppeld aan de Key1 sleutel in de cache. Als de waarde is null, plaatst de Add methode een item in de cache met een sleutel van Key1, een waarde van Value 1, een absolute vervaldatum van 60 seconden en een hoge cacheprioriteit. De methode wordt onRemove ook gebruikt als argument. Hierdoor kan de RemovedCallback methode worden aangeroepen wanneer dit item uit de cache wordt verwijderd.

Note

Zie Toepassingsgegevens in cache opslaan voor voorbeelden van het gebruik van de CacheDependency klasse en de CacheItemRemovedCallback gemachtigde.

public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}

Public Sub AddItemToCache(sender As Object, e As EventArgs)
    itemRemoved = false

    onRemove = New CacheItemRemovedCallback(AddressOf Me.RemovedCallback)

    If (IsNothing(Cache("Key1"))) Then
      Cache.Add("Key1", "Value 1", Nothing, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove)
    End If
End Sub

Opmerkingen

Aanroepen naar deze methode mislukken op de achtergrond als een item met dezelfde key parameter al is opgeslagen in de Cache. Als u een bestaand Cache item met dezelfde key parameter wilt overschrijven, gebruikt u de Insert methode.

U kunt zowel de als slidingExpiration de absoluteExpiration parameters niet instellen. Als u van plan bent het cache-item op een bepaald tijdstip te laten verlopen, stelt u de absoluteExpiration parameter in op het specifieke tijdstip en de slidingExpiration parameter op NoSlidingExpiration.

Als u van plan bent dat het cache-item verloopt nadat een bepaalde tijd is verstreken sinds het item voor het laatst is geopend, stelt u de slidingExpiration parameter in op het verloopinterval en de absoluteExpiration parameter op NoAbsoluteExpiration.

Van toepassing op

Zie ook