MemoryCache Конструкторы

Определение

Пространство имен:

System.Runtime.Caching

Сборка:

System.Runtime.Caching.dll

Пакет:

System.Runtime.Caching v8.0.0

Перегрузки

MemoryCache(String, NameValueCollection)	Инициализирует новый экземпляр класса MemoryCache.
MemoryCache(String, NameValueCollection, Boolean)	Инициализирует новый экземпляр класса MemoryCache.

MemoryCache(String, NameValueCollection)

Исходный код:

MemoryCache.cs

Инициализирует новый экземпляр класса 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)

Параметры

name

String

Имя, используемое для поиска сведений о конфигурации.

Note Он не требуется, чтобы сведения о конфигурации существовали для каждого имени.

Если существует соответствующая запись конфигурации, сведения о конфигурации используются для настройки экземпляра MemoryCache. Если соответствующей записи конфигурации не существует, доступ к имени можно получить через свойство Name, так как указанное имя связано с экземпляром MemoryCache. Сведения о настройке кэша памяти см. в разделе MemoryCacheElement.

config

NameValueCollection

Коллекция пар "имя-значение" сведений о конфигурации, которую необходимо использовать для настройки кэша.

Исключения

ArgumentNullException

name имеет значение null.

ArgumentException

Не удалось проанализировать имя или значение в параметре config.

ConfigurationException

Значение в коллекции config является недопустимым.

Комментарии

При инициализации MemoryCache класса он проверяет наличие записей конфигурации, которые могли быть переопределены с помощью необязательного config параметра в конструкторе. В параметре можно передать следующие параметры config . Все значения могут передаваться в виде целых чисел.

• CacheMemoryLimitMegabytes

• PhysicalMemoryLimitPercentage

• PollingInterval

При вызове этого конструктора параметры конфигурации сначала извлекаются из файлов конфигурации приложения. Если в файле конфигурации приложения нет записей конфигурации, применяются только параметры, указанные в config . Если записи конфигурации в конфигурации приложения существуют и если данные также передаются в config, информация в config переопределяет сведения, считываемые из файла конфигурации.

Значение имени, назначенное экземпляру кэша, используется двумя способами:

• Для отслеживания нескольких экземпляров кэша, если существует несколько экземпляров.

• Ссылка на параметры в файле конфигурации при инициализации экземпляра MemoryCache .

  Примечание

  Механизм принудительного применения уникальных имен для экземпляров кэша отсутствует. Таким образом, можно иметь несколько экземпляров кэша с одинаковыми именами.

  Внимание!

  Не создавайте MemoryCache экземпляры, если это не требуется. При создании экземпляров кэша в клиентских и веб-приложениях MemoryCache экземпляры должны создаваться на ранних этапах жизненного цикла приложения. Необходимо создать только количество экземпляров кэша, которые будут использоваться в приложении, и хранить ссылки на экземпляры кэша в переменных, к которым можно получить глобальный доступ. Например, в ASP.NET приложениях можно хранить ссылки в состоянии приложения. Если вы создаете в приложении только один экземпляр кэша, используйте кэш по умолчанию и получите ссылку на него из Default свойства , когда необходимо получить доступ к кэшу.

MemoryCache(String, NameValueCollection, Boolean)

Исходный код:

MemoryCache.cs

Инициализирует новый экземпляр класса 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)

Параметры

name

String

Имя, используемое для поиска сведений о конфигурации.

config

NameValueCollection

Коллекция пар "имя-значение" сведений о конфигурации, которую необходимо использовать для настройки кэша.

ignoreConfigSection

Boolean

Определяет, следует ли игнорировать раздел конфигурации.