MemoryCache Construtores

Definição

Sobrecargas

Name Description
MemoryCache(String, NameValueCollection)

Inicializa uma nova instância da MemoryCache classe.

MemoryCache(String, NameValueCollection, Boolean)

Inicializa uma nova instância da MemoryCache classe.

MemoryCache(String, NameValueCollection)

Inicializa uma nova instância da MemoryCache classe.

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 usar para consultar informações de configuração.

Note Não é necessário que exista informação de configuração para cada nome.

Se existir uma entrada de configuração correspondente, a informação de configuração é usada para configurar a MemoryCache instância. Se não existir uma entrada de configuração correspondente, o nome pode ser acedido através da Name propriedade, porque o nome especificado está associado à MemoryCache instância. Para informações sobre a configuração da cache de memória, veja MemoryCacheElement.

config
NameValueCollection

Uma coleção de pares nome/valor de informação de configuração para usar na configuração da cache.

Exceções

name é null.

Um nome ou valor no config parâmetro não podia ser analisado.

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

Observações

Quando a MemoryCache classe é inicializada, verifica entradas de configuração que possam ter sido sobrepostas usando o parâmetro opcional config no construtor. Pode passar os seguintes parâmetros no config parâmetro. Todos os valores podem ser passados como inteiros.

Quando este construtor é invocado, as definições de configuração são primeiro recuperadas dos ficheiros de configuração da aplicação. Se não existirem entradas de configuração no ficheiro de configuração da aplicação, apenas as definições fornecidas em config são aplicadas. Se existirem as entradas de configuração na configuração da aplicação, e se a informação também for passada , configa informação no config substitui a informação lida do ficheiro de configuração.

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

  • Para te ajudar a acompanhar múltiplas instâncias de cache quando existem mais do que uma instância.

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

    Note

    Não existe um mecanismo para impor nomes únicos para instâncias de cache. Assim, é possível ter múltiplas instâncias de cache com o mesmo nome.

    Atenção

    Não crie MemoryCache instâncias a menos que seja necessário. Se criar instâncias de cache em aplicações cliente e Web, as MemoryCache instâncias devem ser criadas cedo no ciclo de vida da aplicação. Deve criar apenas o número de instâncias de cache que serão usadas na sua aplicação e armazenar referências às instâncias de cache em variáveis que possam ser acedidas globalmente. Por exemplo, nas aplicações ASP.NET, pode armazenar as referências no estado da aplicação. Se criares apenas uma única instância de cache na tua aplicação, usa a cache por defeito e obtém uma referência a ela a partir da Default propriedade quando precisares de aceder à cache.

Aplica-se a

MemoryCache(String, NameValueCollection, Boolean)

Inicializa uma nova instância da MemoryCache classe.

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 usar para consultar informações de configuração.

config
NameValueCollection

Uma coleção de pares nome/valor de informação de configuração para usar na configuração da cache.

ignoreConfigSection
Boolean

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

Aplica-se a