Cache.Insert Metodo

Definizione

Spazio dei nomi:: System.Web.Caching

Assembly:: System.Web.dll

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 esistente Cache con lo stesso key parametro.

Overload

Nome	Descrizione
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Inserisce un oggetto nell'oggetto Cache con dipendenze, criteri di scadenza e priorità e un delegato che è possibile usare per notificare all'applicazione quando l'elemento inserito viene rimosso da `Cache`.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Inserisce un oggetto nell'oggetto Cache insieme a dipendenze, criteri di scadenza e un delegato che è possibile usare per notificare all'applicazione prima che l'elemento venga rimosso dalla cache.
Insert(String, Object, CacheDependency)	Inserisce un oggetto nell'oggetto Cache con dipendenze di file o chiavi.
Insert(String, Object)	Inserisce un elemento nell'oggetto con una chiave della Cache cache per fare riferimento alla relativa posizione, utilizzando i valori predefiniti forniti dall'enumerazione CacheItemPriority .
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Inserisce un oggetto in Cache con dipendenze e criteri di scadenza.

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

Inserisce un oggetto nell'oggetto Cache con dipendenze, criteri di scadenza e priorità e un delegato che è possibile usare per notificare all'applicazione quando l'elemento inserito viene rimosso da 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 della cache utilizzata per fare riferimento all'oggetto .

value: Object

Oggetto da inserire nella cache.

dependencies: CacheDependency

Dipendenze della chiave del file o della cache per l'elemento. Quando una dipendenza cambia, l'oggetto diventa non valido e viene rimosso dalla cache. Se non sono presenti dipendenze, questo parametro contiene 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 le modifiche dall'ora solare all'ora legale, usare UtcNow anziché Now per questo valore di parametro. Se si usa la scadenza assoluta, il slidingExpiration parametro deve essere NoSlidingExpiration.

slidingExpiration: TimeSpan

Intervallo tra l'ultimo accesso all'oggetto inserito e l'ora in cui scade l'oggetto. Se questo valore è equivalente a 20 minuti, l'oggetto scadrà e verrà rimosso dalla cache 20 minuti dopo l'ultimo accesso. Se si usa la scadenza scorrevole, il absoluteExpiration parametro deve essere NoAbsoluteExpiration.

priority: CacheItemPriority

Costo dell'oggetto rispetto ad altri elementi archiviati nella cache, come espresso dall'enumerazione CacheItemPriority . Questo valore viene usato dalla cache quando rimuove gli oggetti; gli oggetti con un costo inferiore vengono rimossi dalla cache prima degli oggetti con un costo più elevato.

onRemoveCallback: CacheItemRemovedCallback

Delegato che, se specificato, verrà chiamato quando un oggetto viene rimosso dalla cache. È possibile usarlo per notificare alle applicazioni quando i relativi oggetti vengono eliminati dalla cache.

Eccezioni

ArgumentNullException

Il key parametro o value è null.

ArgumentOutOfRangeException

Il parametro viene impostato slidingExpiration su minore TimeSpan.Zero o equivalente di più di un anno.

ArgumentException

I absoluteExpiration parametri e slidingExpiration sono entrambi impostati per l'elemento che si sta tentando di aggiungere a Cache.

Esempio

Nell'esempio seguente viene illustrato come assegnare un elemento ad alta priorità quando lo si inserisce nell'oggetto dell'applicazione Cache .

Note

Per altre informazioni su come usare questo metodo con il CacheItemRemovedCallback delegato, vedere Procedura: Notificare 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 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, impostare 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 a dipendenze, criteri di scadenza e un delegato che è possibile usare per notificare 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 della cache utilizzata per fare riferimento all'oggetto .

value: Object

Oggetto da inserire nella cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

Ora in cui l'oggetto inserito scade e viene rimosso dalla cache. Per evitare possibili problemi con l'ora locale, ad esempio le modifiche dall'ora solare all'ora legale, usare UtcNow invece di Now per questo valore di parametro. Se si usa la scadenza assoluta, il slidingExpiration parametro deve essere impostato su NoSlidingExpiration.

slidingExpiration: TimeSpan

Intervallo tra l'ultimo accesso all'oggetto memorizzato nella cache e l'ora in cui l'oggetto scade. Se questo valore è equivalente a 20 minuti, l'oggetto scadrà e verrà rimosso dalla cache 20 minuti dopo l'ultimo accesso. Se si usa la scadenza scorrevole, il absoluteExpiration parametro deve essere impostato su NoAbsoluteExpiration.

onUpdateCallback: CacheItemUpdateCallback

Delegato che verrà chiamato prima che l'oggetto venga rimosso dalla cache. È possibile usarlo per aggiornare l'elemento memorizzato nella cache e assicurarsi che non venga rimosso dalla cache.

Eccezioni

ArgumentNullException

Il keyparametro , valueo onUpdateCallback è null.

ArgumentOutOfRangeException

Il parametro viene impostato slidingExpiration su minore TimeSpan.Zero o equivalente di più di un anno.

ArgumentException

I absoluteExpiration parametri e slidingExpiration sono entrambi impostati per l'elemento che si sta tentando di aggiungere a Cache.

oppure

Il dependencies parametro è nulle il absoluteExpiration parametro è impostato su NoAbsoluteExpiratione il slidingExpiration parametro è impostato su NoSlidingExpiration.

Commenti

Il Insert metodo consente di inserire un nuovo elemento nella cache e fornire un delegato chiamato prima che l'elemento venga rimosso dalla cache. Nel delegato è possibile aggiornare l'elemento memorizzato nella cache e quindi impedirne la rimozione dalla cache.

Questo metodo sovrascriverà un elemento esistente Cache con lo stesso key parametro.

Se si prevede che l'elemento della cache scada dopo un periodo di tempo impostato dall'ultimo accesso all'elemento, impostare il slidingExpiration parametro sull'intervallo di scadenza e impostare il absoluteExpiration parametro su NoAbsoluteExpiration.

Vedi anche

CacheItemUpdateCallback

Si applica a

Insert(String, Object, CacheDependency)

Inserisce un oggetto nell'oggetto Cache con dipendenze di file o chiavi.

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 della cache utilizzata per identificare l'elemento.

value: Object

Oggetto da inserire nella cache.

dependencies: CacheDependency

Dipendenze della chiave del file o della cache per l'oggetto inserito. Quando una dipendenza cambia, l'oggetto diventa non valido e viene rimosso dalla cache. Se non sono presenti dipendenze, questo parametro contiene null.

Eccezioni

ArgumentNullException

Il key parametro o 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à , Defaultun valore di scadenza variabile di NoSlidingExpiratione un valore di scadenza assoluto pari NoAbsoluteExpirationa .

Vedi anche

CacheDependency

Si applica a

Insert(String, Object)

Inserisce un elemento nell'oggetto con una chiave della Cache 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 della cache utilizzata per fare riferimento all'elemento.

value: Object

Oggetto da inserire nella cache.

Eccezioni

ArgumentNullException

Il key parametro o 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 Insert metodo viene inserito senza dipendenze di file o cache, una priorità di Default, un valore di scadenza scorrevole di NoSlidingExpiratione un valore di scadenza assoluto pari NoAbsoluteExpirationa .

Vedi anche

Memorizzazione nella cache dei dati dell'applicazione

Si applica a

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

Inserisce un oggetto in 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 della cache utilizzata per fare riferimento all'oggetto .

value: Object

Oggetto da inserire nella cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Intervallo tra l'ultimo accesso all'oggetto inserito e l'ora in cui l'oggetto scade. Se questo valore è equivalente a 20 minuti, l'oggetto scadrà e verrà rimosso dalla cache 20 minuti dopo l'ultimo accesso. Se si usa la scadenza scorrevole, il absoluteExpiration parametro deve essere NoAbsoluteExpiration.

Eccezioni

ArgumentNullException

Il key parametro o value è null.

ArgumentOutOfRangeException

Il parametro viene impostato slidingExpiration su minore TimeSpan.Zero o equivalente di più di un anno.

ArgumentException

I absoluteExpiration parametri e slidingExpiration sono entrambi impostati per l'elemento che si sta tentando di aggiungere a Cache.

Esempio

Nell'esempio seguente viene illustrato come inserire un elemento nella cache di un'applicazione con una scadenza assoluta.

Note

Poiché questo formato del metodo Insert supporta le dipendenze della cache, se l'elemento non ha dipendenze, è necessario dichiarare il parametro dependency 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 su DateTime.Now 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 una priorità di Default.

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?