Cache.Insert Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inserisce un elemento nell'oggetto Cache. Utilizzare una delle versioni di questo metodo per sovrascrivere un elemento Cache esistente con lo stesso parametro key.
Overload
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Inserisce un oggetto nell'oggetto Cache con dipendenze e criteri di scadenza e priorità, nonché un delegato da utilizzare per notificare all'applicazione quando l'elemento inserito viene rimosso dalla |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Inserisce un oggetto nell'oggetto Cache, insieme alle dipendenze, ai criteri di scadenza e a un delegato che è possibile utilizzare per inviare una notifica all'applicazione prima che l'elemento venga rimosso dalla cache. |
| Insert(String, Object, CacheDependency) |
Inserisce un oggetto nella Cache con dipendenze di file o chiave. |
| Insert(String, Object) |
Inserisce un elemento nell'oggetto Cache con una chiave di cache per fare riferimento alla relativa posizione, utilizzando i valori predefiniti forniti dall'enumerazione CacheItemPriority. |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan) |
Inserisce un oggetto nella Cache con dipendenze e criteri di scadenza. |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Inserisce un oggetto nell'oggetto Cache con dipendenze e criteri di scadenza e priorità, nonché un delegato da utilizzare per notificare all'applicazione quando l'elemento inserito viene rimosso dalla 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 -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)Parametri
- key
- String
Chiave di cache utilizzata per fare riferimento all'oggetto.
- value
- Object
Oggetto da inserire nella cache.
- dependencies
- CacheDependency
Dipendenze di file o chiave di cache per l'elemento. Al variare di una delle dipendenze, l'oggetto viene invalidato e rimosso dalla cache. In assenza di dipendenze, questo parametro contiene il valore null.
- absoluteExpiration
- DateTime
Ora in cui l'oggetto inserito scade e viene rimosso dalla cache. Per evitare possibili problemi con l'ora locale, ad esempio passaggi dall'ora solare all'ora legale, utilizzare la proprietà UtcNow anziché Now per questo valore di parametro. Se si utilizza la scadenza assoluta, il parametro slidingExpiration deve essere NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Intervallo di tempo tra l'ultimo accesso all'oggetto inserito e la sua scadenza. Se questo valore è pari a 20 minuti, l'oggetto scadrà e verrà rimosso dalla cache 20 minuti dopo l'ultimo accesso. Se si utilizza la scadenza variabile, il parametro absoluteExpiration deve essere NoAbsoluteExpiration.
- priority
- CacheItemPriority
Costo dell'oggetto in relazione agli altri elementi memorizzati nella cache, come è espresso nell'enumerazione CacheItemPriority. La cache utilizza questo valore per la rimozione degli oggetti; gli oggetti con un impiego inferiore vengono rimossi dalla cache prima di quelli con un impiego superiore.
- onRemoveCallback
- CacheItemRemovedCallback
Delegato che, se fornito, verrà chiamato quando un oggetto è rimosso dalla cache. Può essere utilizzato per notificare all'applicazione l'eliminazione dalla cache dei relativi oggetti.
Eccezioni
Il parametro key o il parametro value è null.
Viene impostato il parametro slidingExpiration su un valore inferiore a TimeSpan.Zero o su un valore equivalente a più di un anno.
Entrambi i parametri absoluteExpiration e slidingExpiration vengono impostati per l'elemento che si tenta di aggiungere a Cache.
Esempio
Nell'esempio seguente viene illustrato come assegnare una priorità elevata di un elemento quando lo si inserisce nell'oggetto dell'applicazione Cache .
Nota
Per altre informazioni su come usare questo metodo con il CacheItemRemovedCallback delegato, vedere Procedura: Notifica a un'applicazione quando un elemento viene rimosso dalla cache.
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)
Commenti
Questo metodo sovrascriverà un elemento esistente Cache con lo stesso key parametro.
Non è possibile impostare entrambi i absoluteExpiration parametri e slidingExpiration . Se si intende che l'elemento della cache scada in un momento specifico, impostare il absoluteExpiration parametro sull'ora specifica e il slidingExpiration parametro su NoSlidingExpiration.
Se si intende che l'elemento della cache scada dopo un determinato periodo di tempo trascorso dall'ultimo accesso all'elemento, si imposta il slidingExpiration parametro sull'intervallo di scadenza e il absoluteExpiration parametro su NoAbsoluteExpiration.
Vedi anche
- DateTime
- TimeSpan
- CacheItemPriority
- CacheItemRemovedCallback
- Memorizzazione nella cache dei dati dell'applicazione
Si applica a
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Inserisce un oggetto nell'oggetto Cache, insieme alle dipendenze, ai criteri di scadenza e a un delegato che è possibile utilizzare per inviare una notifica all'applicazione prima che l'elemento venga rimosso dalla cache.
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 -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)Parametri
- key
- String
Chiave di cache utilizzata per fare riferimento all'oggetto.
- value
- Object
Oggetto da inserire nella cache.
- dependencies
- CacheDependency
Dipendenze di file o chiave di cache per l'elemento. Al variare di una delle dipendenze, l'oggetto viene invalidato e rimosso dalla cache. In assenza di dipendenze, questo parametro contiene il valore null.
- absoluteExpiration
- DateTime
Ora in cui l'oggetto inserito scade e viene rimosso dalla cache. Per evitare possibili problemi con l'ora locale, ad esempio passaggi dall'ora solare all'ora legale, utilizzare la proprietà UtcNow anziché Now per questo valore di parametro. Se si utilizza la scadenza assoluta, il parametro slidingExpiration deve essere impostato su NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Intervallo di tempo intercorso tra l'ultimo accesso all'oggetto memorizzato nella cache e la sua scadenza. Se questo valore è pari a 20 minuti, l'oggetto scadrà e verrà rimosso dalla cache 20 minuti dopo l'ultimo accesso. Se si utilizza la scadenza variabile, il parametro absoluteExpiration deve essere impostato su NoAbsoluteExpiration.
- onUpdateCallback
- CacheItemUpdateCallback
Delegato che verrà chiamato prima che l'oggetto venga rimosso dalla cache. Può essere utilizzato per aggiornare l'elemento memorizzato nella cache e assicurarsi che non venga rimosso dalla stessa.
Eccezioni
Il parametro key, value o onUpdateCallback è null.
Viene impostato il parametro slidingExpiration su un valore inferiore a TimeSpan.Zero o su un valore equivalente a più di un anno.
Entrambi i parametri absoluteExpiration e slidingExpiration vengono impostati per l'elemento che si tenta di aggiungere a Cache.
-oppure-
Il parametro dependencies è null, il parametro absoluteExpiration è impostato su NoAbsoluteExpiration e il parametro slidingExpiration è impostato su NoSlidingExpiration.
Commenti
Il Insert metodo consente di inserire un nuovo elemento nella cache e specificare un delegato chiamato prima che l'elemento venga rimosso dalla cache. Nel delegato è possibile aggiornare l'elemento memorizzato nella cache e quindi impedire la rimozione dalla cache.
Questo metodo sovrascriverà un elemento esistente Cache con lo stesso key parametro.
Non è possibile impostare entrambi i absoluteExpiration parametri e slidingExpiration . Se si intende che l'elemento della cache scada in un momento specifico, impostare il absoluteExpiration parametro sull'ora specifica e il slidingExpiration parametro su NoSlidingExpiration.
Se si intende che l'elemento della cache scada dopo un periodo di tempo impostato dopo l'ultimo accesso all'elemento, si imposta il parametro sull'intervallo di scadenza e si imposta il slidingExpirationabsoluteExpiration parametro su NoAbsoluteExpiration.
Vedi anche
Si applica a
Insert(String, Object, CacheDependency)
Inserisce un oggetto nella Cache con dipendenze di file o chiave.
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 -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency)Parametri
- key
- String
Chiave di cache utilizzata per identificare l'elemento.
- value
- Object
Oggetto da inserire nella cache.
- dependencies
- CacheDependency
Dipendenze di file o chiave di cache per l'oggetto inserito. Al variare di una delle dipendenze, l'oggetto viene invalidato e rimosso dalla cache. In assenza di dipendenze, questo parametro contiene il valore null.
Eccezioni
Il parametro key o il parametro value è null.
Esempio
Nell'esempio seguente viene illustrato come inserire un elemento nella cache di un'applicazione con una dipendenza della cache da un file di configurazione XML.
Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));
Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))
Commenti
Questo metodo sovrascriverà un elemento della cache esistente la cui chiave corrisponde al key parametro. L'oggetto aggiunto alla cache usando questo overload del Insert metodo viene inserito con una priorità di , un valore di scadenza scorrevole di DefaultNoSlidingExpiratione un valore di scadenza assoluto di NoAbsoluteExpiration.
Vedi anche
Si applica a
Insert(String, Object)
Inserisce un elemento nell'oggetto Cache con una chiave di cache per fare riferimento alla relativa posizione, utilizzando i valori predefiniti forniti dall'enumerazione CacheItemPriority.
public:
void Insert(System::String ^ key, System::Object ^ value);public void Insert (string key, object value);member this.Insert : string * obj -> unitPublic Sub Insert (key As String, value As Object)Parametri
- key
- String
Chiave di cache utilizzata per fare riferimento all'elemento.
- value
- Object
Oggetto da inserire nella cache.
Eccezioni
Il parametro key o il parametro value è null.
Esempio
Nell'esempio seguente viene illustrato come inserire un elemento nella cache di un'applicazione.
Cache.Insert("DSN", connectionString);
Cache.Insert("DSN", connectionString)
Commenti
Questo metodo sovrascriverà un elemento della cache esistente la cui chiave corrisponde al key parametro. L'oggetto aggiunto alla cache usando questo overload del metodo viene inserito senza dipendenze di Insert file o cache, una priorità di , un valore di scadenza scorrevole di DefaultNoSlidingExpiratione un valore di scadenza assoluto di NoAbsoluteExpiration.
Vedi anche
Si applica a
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Inserisce un oggetto nella Cache con dipendenze e criteri di scadenza.
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 -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)Parametri
- key
- String
Chiave di cache utilizzata per fare riferimento all'oggetto.
- value
- Object
Oggetto da inserire nella cache.
- dependencies
- CacheDependency
Dipendenze di file o chiave di cache per l'oggetto inserito. Al variare di una delle dipendenze, l'oggetto viene invalidato e rimosso dalla cache. In assenza di dipendenze, questo parametro contiene il valore null.
- absoluteExpiration
- DateTime
Ora in cui l'oggetto inserito scade e viene rimosso dalla cache. Per evitare possibili problemi con l'ora locale, ad esempio passaggi dall'ora solare all'ora legale, utilizzare la proprietà UtcNow anziché Now per questo valore di parametro. Se si utilizza la scadenza assoluta, il parametro slidingExpiration deve essere NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Intervallo tra l'ora dell'ultimo accesso dell'oggetto inserito e l'ora di scadenza dell'oggetto. Se questo valore è pari a 20 minuti, l'oggetto scadrà e verrà rimosso dalla cache 20 minuti dopo l'ultimo accesso. Se si utilizza la scadenza variabile, il parametro absoluteExpiration deve essere NoAbsoluteExpiration.
Eccezioni
Il parametro key o il parametro value è null.
Viene impostato il parametro slidingExpiration su un valore inferiore a TimeSpan.Zero o su un valore equivalente a più di un anno.
Entrambi i parametri absoluteExpiration e slidingExpiration vengono impostati per l'elemento che si tenta di aggiungere a Cache.
Esempio
Nell'esempio seguente viene illustrato come inserire un elemento nella cache di un'applicazione con una scadenza assoluta.
Nota
Poiché questa forma del metodo supporta le dipendenze della Insert cache, se l'elemento non ha dipendenze, è necessario dichiarare il dependency parametro come null (Nothing in Visual Basic) nell'elenco delimitato da virgole dei parametri.
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)
Nell'esempio seguente viene illustrato come inserire un elemento nella cache con una scadenza scorrevole.
Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));
Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))
Commenti
Questo metodo sovrascriverà un elemento esistente Cache con lo stesso key parametro.
Se il slidingExpiration parametro è impostato su NoSlidingExpiration, la scadenza scorrevole è disabilitata. Se si imposta il slidingExpiration parametro su maggiore di Zero, il absoluteExpiration parametro viene impostato su Now più il valore contenuto nel slidingExpiration parametro . Se l'elemento viene richiesto dalla cache prima dell'intervallo di tempo specificato dal absoluteExpiration parametro , l'elemento verrà nuovamente inserito nella cache e absoluteExpiration verrà nuovamente impostato DateTime.Now su più il valore contenuto nel slidingExpiration parametro . Se l'elemento non viene richiesto dalla cache prima della data nel absoluteExpiration parametro , l'elemento viene rimosso dalla cache. L'elemento aggiunto alla cache utilizzando questo overload del metodo insert viene inserito con priorità Default.
