ASP.NET 4 快取工作階段狀態提供者的組態設定 (AppFabric 1.1 快取)

本主題涵蓋 ASP.NET AppFabric 工作階段狀態提供者的組態設定。這些設定是在 web.config 檔案中之 sessionState 元素的 providers 區段中指定。

工作階段狀態組態設定

屬性	說明
name (必要)	sessionState 元素所用來參照提供者的「易記」提供者名稱。
type (必要)	提供者的 .NET Framework 型別字串。此屬性應設為 “Microsoft.Web.DistributedCache.DistributedCacheSessionStateStoreProvider, Microsoft.Web.DistributedCache”。
cacheName (必要)	AppFabric 快取的名稱。
dataCacheClientName (選用)	dataCacheClients 組態區段中要使用之 dataCacheClient 區段的名稱。只有在 web.config 檔案中指定多個 dataCacheClient 區段時，此屬性才為必要。根據預設值，提供者會使用 “default” dataCacheClient 區段。
applicationName (選用)	在建立用於儲存工作階段狀態資料的快取金鑰時，提供者所使用的字串值。若未設定此屬性，則只會在相同 Web 應用程式的不同實體例項間共用工作階段狀態 (附帶條件是每個應用程式例項都是以相同 IIS Metabase 路徑進行安裝)。如需詳細資訊，請參閱 https://support.microsoft.com/kb/325056。若有設定此屬性，則會在所有使用相同 applicationName 值的 Web 應用程式間共用工作階段狀態。
useBlobMode (選用)	布林值，指定是否要以單一序列化項目的形式載入及儲存工作階段狀態資料。預設值為 true。若設為 false，提供者會以個別金鑰組的形式載入及儲存工作階段狀態資料。
nonInlinedAdditionalLifetime (選用)	一段時間，可讓提供者用來追蹤要讓個別 (非內嵌) 工作階段狀態項目保持「使用中」必須對其執行動作的下一個時間點。只有在 useBlobMode 設為 false 時才會使用此值。預設值為組態工作階段狀態逾時值的 50% (以分鐘為單位)。此值所使用的字串格式為 "HH:MM:SS"。例如，十分鐘是 "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