Configuration Settings for the ASP.NET 4 Caching Session State Provider (AppFabric 1.1 Caching)

Este tópico aborda as configurações para o provedor de estado da sessão do AppFabric para ASP.NET. Essas configurações estão especificadas na seção providers do elemento sessionState no arquivo web.config.

Configurações do estado da sessão

Atributo	Descrição
name (necessário)	O nome "amigável" do provedor utilizado pelo elemento sessionState para se referenciar ao provedor.
type (necessário)	A cadeia de caracteres de tipo .NET Framework para o provedor. Ela deve ser definida como “Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache”.
cacheName (necessário)	O nome do cache AppFabric.
dataCacheClientName (opcional)	O nome da seção de dataCacheClient para ser usado a partir da seção de configuração de dataCacheClients. Esse atributo será necessário apenas se diversas seções de dataCacheClient forem especificadas no arquivo web.config. Por padrão, o provedor utilizará a seção de dataCacheClient denominada “default”.
applicationName (opcional)	Um valor de cadeia de caracteres utilizado pelo provedor durante a criação de chaves de cache para o armazenamento dos dados de estado da sessão. Quando esse atributo não é definido, o estado da sessão é compartilhado apenas em diferentes instâncias físicas do mesmo aplicativo web (com a solicitação adicional de que cada instância do aplicativo deve ser instalada com o mesmo caminho da metabase IIS). Para obter mais informações, consulte https://support.microsoft.com/kb/325056. Quando esse atributo é definido, o estado da sessão é compartilhado em todos os aplicativos web que utilizarem o mesmo valor applicationName.
useBlobMode (opcional)	Um valor booleano que especifica quando os dados de estado da sessão devem ser carregados e armazenados como um único blob serializado. O padrão é true. Quando definido como false, o provedor carrega e armazena os dados de estado da sessão como pares individuais de chave.
nonInlinedAdditionalLifetime (opcional)	Um timespan que o provedor usa para acompanhar o próximo momento em que um item de estado de sessão (não embutido) individual precisa ser tocado para permanecer "ativo". Esse valor é usado apenas quando useBlobMode é definido como false. O padrão é 50% do valor de tempo limite do estado da sessão de configuração em minutos. O formato da cadeia de caracteres para ser usado com esses valores é "HH:MM:SS". Por exemplo, dez minutos ficariam "00:10:00". Esse valor pode ser diminuído para reduzir a quantidade de tempo que os itens associados às sessões expiradas permanecem em cache.
retryInterval (opcional)	Um timespan para a duração da espera entre as tentativas de recuperação caso ocorra um erro durante a comunicação com o cache. O formato da cadeia de caracteres para ser usado com esse valor é "HH:MM:SS". Por padrão, o provedor ficará suspenso por um segundo.
retryCount (opcional)	Um valor inteiro que avisa ao provedor o número de tentativas de recuperação em caso de falha de comunicação com o cache. Observe que nem todas as operações podem ser recuperadas. O valor padrão é de três tentativas de recuperação. O provedor fica suspenso para o tempo de retryInterval configurado entre cada tentativa de recuperação.
inlinedKeys (opcional)	Um valor de cadeia de caracteres que contém um vírgula ou um ponto-e-vírgula definido para as chaves de estado da sessão cujos valores devem estar embutidos no registro de metadados do estado da sessão. Essa configuração se aplica apenas quando useBlobMode é definido como false. Essa configuração pode ser usada como uma otimização para reduzir as viagens de ida e volta até o cache dos itens de estado da sessão intensamente usados.
maxInlinedStringLength (opcional)	Um valor inteiro que indica o tamanho máximo da cadeia de caracteres para um valor de estado da sessão que será embutido automaticamente no registro de metadados do estado da sessão. Essa configuração se aplica apenas quando useBlobMode é definido como false. O padrão é de 512 caracteres para cadeias de caracteres.

Exemplo

O elemento sessionState do exemplo a seguir utiliza os pares de valor chave individuais para o estado da sessão assim como um nome de aplicativo compartilhado.

<sessionState 
mode="Custom" 
customProvider="DistributedSessionProvider">
      <providers>
        <add name="DistributedSessionProvider"
             type="Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, 
     Microsoft.Web.DistributedCache"
             cacheName="default"
             applicationName="Contoso"
             useBlobMode="true" />
      </providers>
</sessionState>

Consulte também

Conceitos

Provedor de estado da sessão (Cache do AppFabric 1.1)

  2012-03-05