MemoryCache Costruttori

Definizione

Spazio dei nomi:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacchetto:

System.Runtime.Caching v8.0.0

Overload

MemoryCache(String, NameValueCollection)	Inizializza una nuova istanza della classe MemoryCache.
MemoryCache(String, NameValueCollection, Boolean)	Inizializza una nuova istanza della classe MemoryCache.

MemoryCache(String, NameValueCollection)

Origine:

MemoryCache.cs

Inizializza una nuova istanza della classe MemoryCache.

public MemoryCache (string name, System.Collections.Specialized.NameValueCollection config = default);

new System.Runtime.Caching.MemoryCache : string * System.Collections.Specialized.NameValueCollection -> System.Runtime.Caching.MemoryCache

Public Sub New (name As String, Optional config As NameValueCollection = Nothing)

Parametri

name

String

Nome da usare per cercare le informazioni di configurazione.

Note Non è necessario che le informazioni di configurazione esistano per ogni nome.

Se esiste una voce di configurazione corrispondente, le informazioni di configurazione vengono usate per configurare l'istanza di MemoryCache. Se non esiste una voce di configurazione corrispondente, è possibile accedere al nome tramite la proprietà Name, poiché il nome specificato è associato all'istanza di MemoryCache. Per informazioni sulla configurazione della cache, vedere MemoryCacheElement.

config

NameValueCollection

Raccolta di coppie nome/valore delle informazioni di configurazione da usare per configurare la cache.

Eccezioni

ArgumentNullException

name è null.

ArgumentException

Impossibile analizzare un nome o valore nel parametro config.

ConfigurationException

Un valore della raccolta config non è valido.

Commenti

Quando la MemoryCache classe viene inizializzata, controlla le voci di configurazione che potrebbero essere state sostituite usando il parametro facoltativo config nel costruttore. È possibile passare i parametri seguenti nel config parametro . Tutti i valori possono essere passati come interi.

• CacheMemoryLimitMegabytes

• PhysicalMemoryLimitPercentage

• PollingInterval

Quando questo costruttore viene richiamato, le impostazioni di configurazione vengono prima recuperate dai file di configurazione dell'applicazione. Se non esistono voci di configurazione nel file di configurazione dell'applicazione, vengono applicate solo le impostazioni fornite in config . Se le voci di configurazione nella configurazione dell'applicazione esistono e se le informazioni vengono passate anche in config, le informazioni contenute nell'oggetto config sostituiscono le informazioni letti dal file di configurazione.

Il valore del nome assegnato a un'istanza della cache viene usato in due modi:

• Per tenere traccia di più istanze della cache quando esiste più istanze di un'istanza.

• Per fare riferimento alle impostazioni nel file di configurazione quando l'istanza MemoryCache viene inizializzata.

  Nota

  Non esiste alcun meccanismo per applicare nomi univoci per le istanze della cache. Pertanto, è possibile avere più istanze della cache con lo stesso nome.

  Attenzione

  Non creare MemoryCache istanze a meno che non sia necessario. Se si creano istanze della cache nelle applicazioni client e Web, le MemoryCache istanze devono essere create all'inizio del ciclo di vita dell'applicazione. È necessario creare solo il numero di istanze della cache che verranno usate nell'applicazione e archiviare i riferimenti alle istanze della cache nelle variabili a cui è possibile accedere a livello globale. Ad esempio, nelle applicazioni ASP.NET è possibile archiviare i riferimenti nello stato dell'applicazione. Se si crea solo un'istanza di cache singola nell'applicazione, usare la cache predefinita e ottenere un riferimento dalla Default proprietà quando è necessario accedere alla cache.

MemoryCache(String, NameValueCollection, Boolean)

Origine:

MemoryCache.cs

Inizializza una nuova istanza della classe MemoryCache.

public:
 MemoryCache(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config, bool ignoreConfigSection);

public MemoryCache (string name, System.Collections.Specialized.NameValueCollection config, bool ignoreConfigSection);

new System.Runtime.Caching.MemoryCache : string * System.Collections.Specialized.NameValueCollection * bool -> System.Runtime.Caching.MemoryCache

Public Sub New (name As String, config As NameValueCollection, ignoreConfigSection As Boolean)

Parametri

name

String

Nome da usare per cercare le informazioni di configurazione.

config

NameValueCollection

Raccolta di coppie nome/valore delle informazioni di configurazione da usare per configurare la cache.

ignoreConfigSection

Boolean

Indica se la sezione di configurazione deve essere ignorata.