Cache.Insert Metodo

Definizione

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 Cache.

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 -> 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)

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

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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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.

Vedi anche

Si applica a