MemoryCache Construtores

Definição

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacote:

System.Runtime.Caching v8.0.0

Sobrecargas

MemoryCache(String, NameValueCollection)	Inicializa uma nova instância da classe MemoryCache.
MemoryCache(String, NameValueCollection, Boolean)	Inicializa uma nova instância da classe MemoryCache.

MemoryCache(String, NameValueCollection)

Origem:

MemoryCache.cs

Inicializa uma nova instância da 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)

Parâmetros

name

String

O nome a ser usado para pesquisar informações de configuração.

Note Não é obrigatório que existam informações de configuração para cada nome.

Se houver uma entrada de configuração correspondente, as informações de configuração serão usadas para configurar a instância de MemoryCache. Se não existir uma entrada de configuração correspondente, o nome poderá ser acessado por meio da propriedade Name, porque o nome especificado está associado à instância de MemoryCache. Para obter mais informações sobre a configuração de cache de memória, consulte MemoryCacheElement.

config

NameValueCollection

Uma coleção de pares nome/valor das informações de configuração a serem usadas para configurar o cache.

Exceções

ArgumentNullException

name é null.

ArgumentException

Um nome ou valor no parâmetro config não pôde ser analisado.

ConfigurationException

Um valor da coleção config é inválido.

Comentários

Quando a MemoryCache classe é inicializada, ela verifica se há entradas de configuração que podem ter sido substituídas usando o parâmetro opcional config no construtor. Você pode passar os parâmetros a seguir no config parâmetro . Todos os valores podem ser passados como inteiros.

• CacheMemoryLimitMegabytes

• PhysicalMemoryLimitPercentage

• PollingInterval

Quando esse construtor é invocado, as definições de configuração são recuperadas primeiro dos arquivos de configuração do aplicativo. Se não houver entradas de configuração no arquivo de configuração do aplicativo, somente as configurações fornecidas em config serão aplicadas. Se as entradas de configuração na configuração do aplicativo existirem e se as informações também forem passadas em config, as informações no config substituirão as informações lidas do arquivo de configuração.

O valor do nome atribuído a uma instância de cache é usado de duas maneiras:

• Para ajudá-lo a controlar várias instâncias de cache quando houver mais de uma instância.

• Para referenciar as configurações no arquivo de configuração quando a MemoryCache instância for inicializada.

  Observação

  Não há mecanismo para impor nomes exclusivos para instâncias de cache. Portanto, é possível ter várias instâncias de cache com o mesmo nome.

  Cuidado

  Não crie MemoryCache instâncias, a menos que seja necessário. Se você criar instâncias de cache em aplicativos Cliente e Web, as MemoryCache instâncias deverão ser criadas no início do ciclo de vida do aplicativo. Você deve criar apenas o número de instâncias de cache que serão usadas em seu aplicativo e armazenar referências às instâncias de cache em variáveis que podem ser acessadas globalmente. Por exemplo, em aplicativos ASP.NET, você pode armazenar as referências no estado do aplicativo. Se você criar apenas uma única instância de cache em seu aplicativo, use o cache padrão e obtenha uma referência a ela da Default propriedade quando precisar acessar o cache.

MemoryCache(String, NameValueCollection, Boolean)

Origem:

MemoryCache.cs

Inicializa uma nova instância da 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)

Parâmetros

name

String

O nome a ser usado para pesquisar informações de configuração.

config

NameValueCollection

Uma coleção de pares nome/valor das informações de configuração a serem usadas para configurar o cache.

ignoreConfigSection

Boolean

Indica se a seção de configuração deve ser ignorada.