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


Параметры конфигурации поставщика состояний сеансов кэша ASP.NET 4 (кэширование в AppFabric 1.1)

В этом разделе описаны параметры конфигурации поставщика состояний сеансов AppFabric для ASP.NET. Эти параметры указываются в разделе providers элемента sessionState в файле web.config.

Параметры конфигурации состояния сеансов

Атрибут Описание

name (обязательный)

Понятное имя поставщика, используемое в элементе sessionState для ссылки на поставщик.

type (обязательный)

Строка типа поставщика .NET Framework. Следует задать значение “Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache”.

cacheName (обязательный)

Имя кэша AppFabric.

dataCacheClientName (необязательный)

Имя раздела dataCacheClient для использования в разделе настройки dataCacheClients. Этот атрибут необходим только в случае, если в файле web.config задается несколько разделов dataCacheClient. По умолчанию поставщик будет использовать раздел dataCacheClient с именем “default”.

applicationName (необязательный)

Строка, используемая поставщиком при создании ключей кэша для хранения данных о состоянии сеансов. Если этот атрибут не задан, состояние сеанса доступно только в разных физических экземплярах одного веб-приложения (при этом все они должны находиться по одному и тому же пути в метабазе IIS). Дополнительные сведения см. в статье https://support.microsoft.com/kb/325056. Если этот атрибут задан, состояние сеанса будет доступно всем веб-приложениям, использующим одно и то же значение applicationName.

useBlobMode (необязательный)

Логическое значение, указывающее на необходимость загрузки и хранения данных состояния сеанса в форме единого сериализованного большого двоичного объекта. Значение по умолчанию – true. Если значение равно false, поставщик загружает и хранит данные состояний сеансов в форме отдельных пар "ключ-значение".

nonInlinedAdditionalLifetime (необязательный)

Временной промежуток, используемый поставщиком для отслеживания очередного момента, когда определенный (не встроенный) элемент состояния сеанса следует "тронуть", чтобы он остался в кэше. Это значение используется только в случае, если атрибут useBlobMode равен false. Значение по умолчанию – 50 % значения времени ожидания состояния сеанса в конфигурации. Формат строки – "ЧЧ:ММ:СС". Так, десять минут – это "00:10:00". Это значение можно уменьшить, чтобы сократить время, в течение которого элементы сеансов с истекшим временем существования остаются в кэше.

retryInterval (необязательный)

Временной промежуток между попытками повтора при возникновении ошибки при взаимодействии с кэшем. Формат строки здесь – "HH:MM:SS". По умолчанию поставщик будет ждать одну секунду.

retryCount (необязательный)

Целочисленное значение, обозначающее количество попыток повтора в случае сбоя при взаимодействии с кэшем. Обратите внимание, что повторять можно не все операции. Значение по умолчанию – три попытки. Между попытками поставщик выжидает в течение указанного времени (retryInterval).

inlinedKeys (необязательный)

Строка с разделенными запятыми или точками с запятой ключами состояния сеанса, значения которых следует встроить в запись метаданных состояния сеанса. Это значение используется только в случае, если атрибут useBlobMode равен false. Этот параметр можно использовать для оптимизации, чтобы сократить время обращения в кэше для активно используемых элементов состояния сеансов.

maxInlinedStringLength (необязательный)

Целочисленное значение, задающее максимальный размер значения состояния сеанса, которое будет автоматически встраиваться в запись метаданных состояния сеанса. Это значение используется только в случае, если атрибут useBlobMode равен false. По умолчанию используется значение 512.

Пример

В следующем примере элемент sessionState задает отдельные пары "ключ-значение" для состояний сеансов, а также общее имя приложения.

<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>

См. также

Основные понятия

Поставщик состояний сеансов (кэширование в AppFabric 1.1)

  2012-03-05