Поделиться через


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

Определение

Перегрузки

MemoryCache(String, NameValueCollection)

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

MemoryCache(String, NameValueCollection, Boolean)

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

MemoryCache(String, NameValueCollection)

Исходный код:
MemoryCache.cs
Исходный код:
MemoryCache.cs
Исходный код:
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

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

Исключения

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

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

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

Комментарии

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

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

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

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

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

    Примечание

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

    Внимание!

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

Применяется к

MemoryCache(String, NameValueCollection, Boolean)

Исходный код:
MemoryCache.cs
Исходный код:
MemoryCache.cs
Исходный код:
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

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

Применяется к