MemoryCache Costruttori

Definizione

Overload

MemoryCache(String, NameValueCollection)

Inizializza una nuova istanza della classe MemoryCache.Initializes a new instance of the MemoryCache class.

MemoryCache(String, NameValueCollection, Boolean)

Inizializza una nuova istanza della classe MemoryCache.Initializes a new instance of the MemoryCache class.

MemoryCache(String, NameValueCollection)

Inizializza una nuova istanza della classe MemoryCache.Initializes a new instance of the MemoryCache class.

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.The name to use to look up configuration information.

Nota Non è richiesto per la presenza delle informazioni di configurazione per ogni nome.Note It is not required for configuration information to exist for every name.

Se esiste una voce di configurazione corrispondente, le informazioni di configurazione vengono usate per configurare l'istanza di MemoryCache.If a matching configuration entry exists, the configuration information is used to configure the MemoryCache instance. 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.If a matching configuration entry does not exist, the name can be accessed through the Name property, because the specified name is associated with the MemoryCache instance. Per informazioni sulla configurazione della cache, vedere MemoryCacheElement.For information about memory cache configuration, see MemoryCacheElement.

config
NameValueCollection

Raccolta di coppie nome/valore delle informazioni di configurazione da usare per configurare la cache.A collection of name/value pairs of configuration information to use for configuring the cache.

Eccezioni

name è null.name is null.

Impossibile analizzare un nome o valore nel parametro config.A name or value in the config parameter could not be parsed.

Un valore della raccolta config non è valido.A value in the config collection is invalid.

Commenti

Quando la MemoryCache classe viene inizializzata, viene verificata la presenza di voci di configurazione che potrebbero essere state sostituite tramite il config parametro facoltativo nel costruttore.When the MemoryCache class is initialized, it checks for configuration entries that might have been overridden by using the optional config parameter in the constructor. È possibile passare i parametri seguenti nel config parametro.You can pass the following parameters in the config parameter. Tutti i valori possono essere passati come numeri interi.All values can be passed as integers.

Quando questo costruttore viene richiamato, le impostazioni di configurazione vengono prima recuperate dai file di configurazione dell'applicazione.When this constructor is invoked, configuration settings are first retrieved from application configuration files. Se nel file di configurazione dell'applicazione non sono presenti voci di configurazione, verranno applicate solo le impostazioni specificate in config .If no configuration entries exist in the application configuration file, only the settings provided in config are applied. Se le voci di configurazione nella configurazione dell'applicazione esistono e se vengono passate anche le informazioni config , le informazioni contenute in eseguono l' config override delle informazioni lette dal file di configurazione.If the configuration entries in the application configuration exist, and if information is also passed in config, the information in the config overrides the information that is read from the configuration file.

Il valore del nome assegnato a un'istanza della cache viene usato in due modi:The name value that is assigned to a cache instance is used in two ways:

  • Per tenere traccia di più istanze della cache quando esiste più di un'istanza.To help you keep track of multiple cache instances when more than one instance exists.

  • Per fare riferimento alle impostazioni nel file di configurazione quando l' MemoryCache istanza viene inizializzata.To reference settings in the configuration file when the MemoryCache instance is initialized.

    Nota

    Non esiste alcun meccanismo per applicare nomi univoci per le istanze della cache.There is no mechanism to enforce unique names for cache instances. Pertanto, è possibile avere più istanze della cache con lo stesso nome.Therefore, it is possible to have multiple cache instances with the same name.

    Attenzione

    Non creare MemoryCache istanze a meno che non sia necessario.Do not create MemoryCache instances unless it is required. Se si creano istanze della cache nelle applicazioni client e Web, le MemoryCache istanze devono essere create prima del ciclo di vita dell'applicazione.If you create cache instances in client and Web applications, the MemoryCache instances should be created early in the application life cycle. È necessario creare solo il numero di istanze della cache che verranno utilizzate nell'applicazione e archiviare i riferimenti alle istanze della cache nelle variabili a cui è possibile accedere a livello globale.You must create only the number of cache instances that will be used in your application, and store references to the cache instances in variables that can be accessed globally. Ad esempio, nelle applicazioni ASP.NET è possibile archiviare i riferimenti nello stato dell'applicazione.For example, in ASP.NET applications, you can store the references in application state. Se si crea una sola istanza della cache nell'applicazione, usare la cache predefinita e ottenere un riferimento a tale istanza dalla Default proprietà quando è necessario accedere alla cache.If you create only a single cache instance in your application, use the default cache and get a reference to it from the Default property when you need to access the cache.

Si applica a

MemoryCache(String, NameValueCollection, Boolean)

Inizializza una nuova istanza della classe MemoryCache.Initializes a new instance of the MemoryCache class.

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.The name to use to look up configuration information.

config
NameValueCollection

Raccolta di coppie nome/valore delle informazioni di configurazione da usare per configurare la cache.A collection of name/value pairs of configuration information to use for configuring the cache.

ignoreConfigSection
Boolean

Indica se la sezione di configurazione deve essere ignorata.Indicates whether the configuration section should be ignored.

Si applica a