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

Определение

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

System.Runtime.Caching

Сборка:

System.Runtime.Caching.dll

Перегрузки

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

MemoryCache(String, NameValueCollection)

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

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

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

Если существует соответствующая запись конфигурации, сведения о конфигурации используются для настройки экземпляра 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.

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

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