Cache.Insert Methode

Definitie

Naamruimte:: System.Web.Caching

Assembly:: System.Web.dll

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 item in het Cache object in. Gebruik een van de versies van deze methode om een bestaand Cache item met dezelfde key parameter te overschrijven.

Overloads

Name	Description
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Hiermee voegt u een object in het object in 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`.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Hiermee voegt u een object in het Cache object in, samen met afhankelijkheden, verloopbeleid en een gemachtigde die u kunt gebruiken om de toepassing op de hoogte te stellen voordat het item uit de cache wordt verwijderd.
Insert(String, Object, CacheDependency)	Hiermee voegt u een object in het Cache object met bestands- of sleutelafhankelijkheden in.
Insert(String, Object)	Hiermee voegt u een item in het Cache object in met een cachesleutel om naar de locatie te verwijzen, met behulp van standaardwaarden die worden opgegeven door de CacheItemPriority opsomming.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Hiermee voegt u een object toe aan het Cache object met afhankelijkheden en verloopbeleid.

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Hiermee voegt u een object in het object in 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:
 void Insert(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 void Insert(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.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)

Parameters

key: String

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

value: Object

Het object dat moet worden ingevoegd in 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 ingevoegde object verloopt en wordt verwijderd uit de cache. Gebruik in plaats Now van voor deze parameterwaarde mogelijke problemen met lokale tijd, zoals wijzigingen van standaardtijd tot zomertijdUtcNow. Als u absolute vervaldatum gebruikt, moet de slidingExpiration parameter zijn NoSlidingExpiration.

slidingExpiration: TimeSpan

Het interval tussen de tijd dat het ingevoegde 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 een schuifverlooptijd gebruikt, moet de absoluteExpiration parameter zijn NoAbsoluteExpiration.

priority: CacheItemPriority

De kosten van het object ten opzichte van andere items die zijn opgeslagen in de cache, zoals uitgedrukt in de CacheItemPriority opsomming. Deze waarde wordt door de cache gebruikt 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.

Uitzonderingen

ArgumentNullException

De key of value parameter is null.

ArgumentOutOfRangeException

U stelt de slidingExpiration parameter in op minder dan TimeSpan.Zero of het equivalent van 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 ziet u hoe u een item met hoge prioriteit toewijst wanneer u het invoegt in het object van Cache uw toepassing.

Note

Zie How to: Notify an Application When an Item Is Removed from the Cache (Een toepassing waarschuwen wanneer een item uit de cache wordt verwijderd) voor meer informatie over het gebruik van deze methode met de CacheItemRemovedCallback gemachtigde.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove)

Opmerkingen

Met deze methode wordt een bestaand Cache item met dezelfde key parameter overschreven.

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 het cache-item te laten verlopen nadat een bepaalde tijd is verstreken sinds de laatste toegang tot het item, stelt u de slidingExpiration parameter in op het verloopinterval en de absoluteExpiration parameter op NoAbsoluteExpiration.

Zie ook

Van toepassing op

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

Hiermee voegt u een object in het Cache object in, samen met afhankelijkheden, verloopbeleid en een gemachtigde die u kunt gebruiken om de toepassing op de hoogte te stellen voordat het item uit de cache wordt verwijderd.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);

public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)

Parameters

key: String

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

value: Object

Het object dat in de cache moet worden ingevoegd.

dependencies: CacheDependency

absoluteExpiration: DateTime

Het tijdstip waarop het ingevoegde object verloopt en wordt verwijderd uit de cache. Gebruik in plaats van Now voor deze parameterwaarde mogelijke problemen met lokale tijd, zoals wijzigingen van standaardtijd tot zomertijdUtcNow. Als u absolute vervaldatum gebruikt, moet de slidingExpiration parameter worden ingesteld op NoSlidingExpiration.

slidingExpiration: TimeSpan

Het interval tussen de tijd dat het object in de cache 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 een schuifverlooptijd gebruikt, moet de absoluteExpiration parameter worden ingesteld op NoAbsoluteExpiration.

onUpdateCallback: CacheItemUpdateCallback

Een gemachtigde die wordt aangeroepen voordat het object uit de cache wordt verwijderd. U kunt dit gebruiken om het item in de cache bij te werken en ervoor te zorgen dat het niet uit de cache wordt verwijderd.

Uitzonderingen

ArgumentNullException

De keyparameter , valueof onUpdateCallback parameter is null.

ArgumentOutOfRangeException

U stelt de slidingExpiration parameter in op minder dan TimeSpan.Zero of het equivalent van meer dan één jaar.

ArgumentException

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

– of –

De dependencies parameter is null, en de absoluteExpiration parameter is ingesteld op NoAbsoluteExpiration, en de slidingExpiration parameter is ingesteld op NoSlidingExpiration.

Opmerkingen

Met de Insert methode kunt u een nieuw item invoegen in de cache en een gemachtigde opgeven die wordt aangeroepen voordat het item uit de cache wordt verwijderd. In de gemachtigde kunt u het item in de cache bijwerken en zo voorkomen dat het uit de cache wordt verwijderd.

Met deze methode wordt een bestaand Cache item met dezelfde key parameter overschreven.

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

Zie ook

CacheItemUpdateCallback

Van toepassing op

Insert(String, Object, CacheDependency)

Hiermee voegt u een object in het Cache object met bestands- of sleutelafhankelijkheden in.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);

public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies);

member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency)

Parameters

key: String

De cachesleutel die wordt gebruikt om het item te identificeren.

value: Object

Het object dat moet worden ingevoegd in de cache.

dependencies: CacheDependency

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

Uitzonderingen

ArgumentNullException

De key of value parameter is null.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een item invoegt in de cache van een toepassing met een cacheafhankelijkheid van een XML-configuratiebestand.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

Opmerkingen

Met deze methode wordt een bestaand cache-item overschreven waarvan de sleutel overeenkomt met de key parameter. Het object dat is toegevoegd aan de cache met behulp van deze overbelasting van de Insert methode, wordt ingevoegd met een prioriteit van Default, een schuifverloopwaarde van NoSlidingExpirationen een absolute vervaldatumwaarde van NoAbsoluteExpiration.

Zie ook

CacheDependency

Van toepassing op

Insert(String, Object)

Hiermee voegt u een item in het Cache object in met een cachesleutel om naar de locatie te verwijzen, met behulp van standaardwaarden die worden opgegeven door de CacheItemPriority opsomming.

public:
 void Insert(System::String ^ key, System::Object ^ value);

public void Insert(string key, object value);

member this.Insert : string * obj -> unit

Public Sub Insert (key As String, value As Object)

Parameters

key: String

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

value: Object

Het object dat moet worden ingevoegd in de cache.

Uitzonderingen

ArgumentNullException

De key of value parameter is null.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een item invoegt in de cache van een toepassing.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Opmerkingen

Met deze methode wordt een bestaand cache-item overschreven waarvan de sleutel overeenkomt met de key parameter. Het object dat aan de cache wordt toegevoegd met deze overbelasting van de Insert methode, wordt ingevoegd zonder afhankelijkheden van bestanden of caches, een prioriteit van Default, een glijdende verloopwaarde van NoSlidingExpirationen een absolute verloopwaarde van NoAbsoluteExpiration.

Zie ook

Toepassingsgegevens opslaan in cache

Van toepassing op

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

Hiermee voegt u een object toe aan het Cache object met afhankelijkheden en verloopbeleid.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);

public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)

Parameters

key: String

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

value: Object

Het object dat moet worden ingevoegd in de cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Het interval tussen het tijdstip waarop het ingevoegde object voor het laatst wordt 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 een schuifverlooptijd gebruikt, moet de absoluteExpiration parameter zijn NoAbsoluteExpiration.

Uitzonderingen

ArgumentNullException

De key of value parameter is null.

ArgumentOutOfRangeException

U stelt de slidingExpiration parameter in op minder dan TimeSpan.Zero of het equivalent van 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 ziet u hoe u een item invoegt in de cache van een toepassing met een absolute vervaldatum.

Note

Aangezien deze vorm van de methode Insert cacheafhankelijkheden ondersteunt, moet u, als het item geen afhankelijkheden heeft, de parameter dependency declareren als null (Nothing in Visual Basic) in de door komma's gescheiden lijst met parameters.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

In het volgende voorbeeld ziet u hoe u een item in de cache invoegt met een schuifverlooptijd.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));

Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

Opmerkingen

Met deze methode wordt een bestaand Cache item met dezelfde key parameter overschreven.

Als de slidingExpiration parameter is ingesteld op NoSlidingExpiration, wordt de verlooptijd van de schuif uitgeschakeld. Als u de slidingExpiration parameter instelt op groter dan Zero, wordt de absoluteExpiration parameter ingesteld op Now plus de waarde in de slidingExpiration parameter. Als het item wordt aangevraagd in de cache vóór de hoeveelheid tijd die is opgegeven door de absoluteExpiration parameter, wordt het item opnieuw in de cache geplaatst en absoluteExpiration wordt het opnieuw ingesteld op DateTime.Now plus de waarde in de slidingExpiration parameter. Als het item niet wordt aangevraagd in de cache vóór de datum in de absoluteExpiration parameter, wordt het item uit de cache verwijderd. Het item dat aan de cache wordt toegevoegd met deze overbelasting van de invoegmethode, wordt ingevoegd met een prioriteit van Default.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?