sessionState öğesi (asp.net Ayarlar Şeması)

Makale
08/01/2011

Geçerli uygulamanın oturum durumu ayarlarını yapılandırır.

<sessionState 
    mode="[Off|InProc|StateServer|SQLServer|Custom]"
    timeout="number of minutes"
    cookieName="session identifier cookie name"
    cookieless=
         "[true|false|AutoDetect|UseCookies|UseUri|UseDeviceProfile]"
    regenerateExpiredSessionId="[True|False]"
    sessionIDManagerType="session manager type"
    sqlConnectionString="sql connection string"
    sqlCommandTimeout="number of seconds"
    allowCustomSqlDatabase="[True|False]"
    useHostingIdentity="[True|False]"
    stateConnectionString="tcpip=server:port"
    stateNetworkTimeout="number of seconds"
    customProvider="custom provider name"
    compressionEnabled="[True|False]"
    sqlConnectionRetryInterval="number of seconds">
    <providers>...</providers>
</sessionState>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Açyklama
allowCustomSqlDatabase	İsteğe bağlı Boolean özniteliği. Oturum durumu sql veritabanına asp yerine özel bir veritabanı olup olmadığını belirtir.net varsayılan veritabanı. false, Bir başlangıç kataloğu veya bir veritabanı için değer olarak belirtemezsiniz sqlConnectionString özniteliği. Varsayılan oturum durumu sql veritabanını ASPState veritabanıdır. Daha fazla bilgi için bkz. Oturum durum modu. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan, false değeridir.
compressionEnabled	İsteğe bağlı Boolean özniteliği. Oturum durumu verileri sıkıştırma uygulanıp uygulanmayacağını belirtir. Varsayılan, false değeridir.
cookieless	İsteğe Bağlı HttpCookieMode özniteliği Tanımlama bilgileri Web uygulaması için nasıl kullanıldığını belirtir. cookieless özniteliği aşağıdaki değerlerden herhangi biri olabilir. Varsayılan, UseCookies değeridir. Not Bir ajax etkinleştirilmiş asp yapılandırırken.net Web sitesi, yalnızca varsayılan değeri kullanın UseCookies için cookieless özniteliği.URL'ye kodlanmış tanımlama bilgilerini kullanan ayarları asp tarafından desteklenmiyor.net ajax istemci kod kitaplıkları. ValueAçyklama AutoDetect ASP.net, istekte bulunan tarayıcı veya aygıt tanımlama bilgilerini destekleyip desteklemediğini belirler.Tanımlama bilgileri, istekte bulunan tarayıcı veya aygıtı destekliyorsa, AutoDetect için kullanıcı verilerini; kalıcı tanımlama bilgileri kullanır Aksi durumda, sorgu dizesinde tanımlayıcı kullanılır.Tarayıcı veya aygıt tanımlama bilgilerini destekleyen, ancak tanımlama bilgileri devre dışı, tanımlama bilgileri yine isteyen özelliği tarafından kullanılır. UseCookies Tanımlama bilgileri, kullanıcı verileri, tarayıcı veya aygıt tanımlama bilgilerini destekleyip olsun persist. UseDeviceProfile ASP.net göre tanımlama bilgilerini kullanıp kullanmayacağınızı belirler HttpBrowserCapabilities ayarı.HttpBrowserCapabilities Ayarını gösterir, tarayıcı veya aygıt tanımlama bilgilerini destekleyen, tanımlama bilgilerini kullanılır; Aksi durumda, sorgu dizesinde tanımlayıcı kullanılır. UseUri Arama özelliği, tarayıcı veya aygıt tanımlama bilgilerini destekleyip bakılmaksızın bir tanımlayıcıyı depolamak için sorgu dizesini kullanır.
cookieName	İsteğe bağlı String özniteliği. Oturum tanımlayıcısı depolayan tanımlama bilgisinin adını belirtir. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan, "ASP.NET_SessionId" değeridir.
customProvider	İsteğe bağlı String özniteliği. Depolamak ve oturum durumu verileri almak için kullanılacak özel oturum durumu sağlayıcının adını belirtir. Belirtilen sağlayıcı sağlayıcıları öğesi. Sağlayıcı yalnızca oturum durumu modu ayarlandığında kullanılan Custom değer. Daha fazla bilgi için bkz. Oturum durum modu. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan değer, boş dizedir ("").
mode	İsteğe Bağlı SessionStateMode özniteliği Oturum durumu değerlerini depolanacağı konumu belirtir. Daha fazla bilgi için bkz. Oturum durum modu. mode özniteliği aşağıdaki değerlerden herhangi biri olabilir. Varsayılan, InProc değeridir. ValueAçyklama Custom Oturum durumu bir özel veri mağazalar oturum durumu bilgilerini kullanıyor. InProc Oturum durumunu işlem bir asp ile kullanılıyor.net alt işlem. Off Oturum durumu devre dışı bırakılır. SQLServer Oturum durumu, durum bilgilerini saklamak için bir işlem sql Server veritabanı kullanıyor. StateServer Oturum durumunu işlem dışı asp kullanıyor.Durum bilgilerini depolamak için net durum hizmeti'ni kullanın.
partitionResolverType	İsteğe bağlı String özniteliği. Oturum durumunun nerede depolanacağını belirtir. Bir değer belirtilmişse partitionResolverType özniteliği, sqlConnectionString ve stateConnectionString öznitelikler yoksayılır. Tarafından döndürülen bağlantı dizesi PartitionResolverType özelliği her isteği geri kalanı için uygun sunucu konumuna bağlanmak için kullanılıristeği. Bağlantı dizesi geçerli değil, asp.net sunucu için yapılandırılmış bağlantı dizesi geçerli değil atılır, aynı istisna atar. Bu özellik, oturum durumu verilerini sql veya durum sunucusu modunda olduğunda birden çok arka uç düğümlere bölümlemek için kullanılır. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan değer, boş dizedir.
regenerateExpiredSessionId	İsteğe bağlı Boolean özniteliği. İstemci tarafından süresi dolmuş oturum kimliği belirtildiğinde oturum kimliği yeniden olup olmadığını belirtir. Varsayılan olarak, oturum kimlikleri yalnızca yeniden cookieless mod, regenerateExpiredSessionId etkindir. Daha fazla bilgi için bkz. IsCookieless. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan, true değeridir.
sessionIDManagerType	İsteğe bağlı String özniteliği. Kimlik Yöneticisi'ni oturum tam türünü belirtir. Varsayılan değer boş bir dizedir.
sqlCommandTimeout	İsteğe bağlı TimeSpan özniteliği. sql Server oturum durumu modunu kullanan sql komutları için süre zaman aşımı saniye cinsinden belirtir. Süre aşımı bir sql komutu iptal edilir önce boşta kalabileceği saniye sayısıdır. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan değer 0:00:30 (30 saniye)'tir.
sqlConnectionRetryInterval	İsteğe bağlı TimeSpan özniteliği. Veritabanına bağlanmak için girişimleri arasındaki, saniye cinsinden zaman aralığını belirtir. Varsayılan değer 0’dur.
sqlConnectionString	İsteğe bağlı String özniteliği. sql Server çalıştıran bir bilgisayar için bağlantı dizesini belirtir. Bu öznitelik gereklidir mode özniteliği ayarlanmışsa SQLServer değer. Daha fazla bilgi için bkz. Oturum durum modu. Ya da bu öznitelik adlandırılmış bir ayarlayabileceğiniz sqlConnectionString dan connectionStrings düğümü veya aşağıdaki sözdizimini kullanın: `sqlConnectionString="Data Source=.\SQLServer2005;Initial Catalog=SessionState;Integrated Security=SSPI;"` Not Kullanmakta olduğunuz uygulamanın güvenliğini artırmak için SQLServer modu, kullanımKorumalı yapılandırma korunmasına yardımcı olmak için sqlConnectionString şifreleme tarafından değeri sessionState yapılandırmanızın bölüm. Varsayılan, "data source=127.0.0.1;Integrated Security=SSPI" değeridir.
stateConnectionString	İsteğe bağlı String özniteliği. Sunucu adı veya adresi ve bağlantı noktası oturum durumunu uzaktan depolandığı belirtir. Bağlantı noktası değeri olmalıdır 42424. Bu öznitelik gereklidir mode olan StateServer değer. Emin olun asp.net durum hizmeti, oturum durumu bilgileri saklayan uzak sunucu üzerinde çalışıyor. Bu hizmet, asp ile yüklenir.net ve varsayılan olarak % windir%\Microsoft.NET\Framework\VersionNumber\aspnet_state.exe bulunur. Daha fazla bilgi için bkz. Oturum durum modu. Not Kullanırken uygulamanızın güvenliğini artırmak için StateServer modu, kullanımKorumalı yapılandırma korunmasına yardımcı olmak için stateConnectionString şifreleme tarafından değeri sessionStatebölümünde. Varsayılan, "tcpip=127.0.0.1:42424" değeridir.
stateNetworkTimeout	İsteğe bağlı TimeSpan özniteliği. İstek iptal önce Web sunucusu ve durum sunucusu arasındaki TCP/IP ağ bağlantısının boşta kalabileceği saniye sayısını belirtir. Bu özniteliği kullanılır, mode özniteliği ayarlanmışsa StateServer değer. Varsayılan değer 10 saniye.
timeout	İsteğe bağlı TimeSpan özniteliği. Bir oturumun kapatılmadan önce kaç dakika süreyle boşta kalabileceğini belirtir. timeout Özniteliği, 525,600 dakika (1 yıl)'den daha büyük bir değere ayarlanamazişlem ve durum sunucusu modları. Oturum timeout yapılandırma ayarı yalnızca asp için geçerlidir.net sayfaları. Oturum değiştirme timeout değeri için oturum zaman aşımını etkilemezasp sayfaları. Benzer şekilde, asp sayfaları için oturum zaman aşımını değiştirmek oturum zaman aşımını asp etkilemez.net sayfaları. Varsayılan değer 20 dakikadır.
useHostingIdentity	İsteğe bağlı Boolean özniteliği. Oturum durumu veya barındıran kimliğine dönmek istemci kimliğe bürünme kullanan belirtir. true, asp.net bağlandığında aşağıdaki işlem kimlik bilgilerini kullanarak oturum durumu depo: aspnet Microsoft Internet Information Services (IIS) sürüm 5 ve 5.1 veya Microsoft Windows Server 2003 için hizmet ağı olan barındırma işlemi. Aşağıdaki yapılandırma kullanıldığında, uygulama kimliğe bürünme kimlik: <identity impersonate="true" userName="etki alanı\kullanıcı adı" password="güvenli parola" /> false, asp.net bağlar için geçerli bir istek. işletim sistemi iş parçacığı ile şu anda ilişkili olan kimlik bilgilerini kullanarak oturum durumu deposuna İstemcinin kimliğe bürünme özelliğinin için asp.net, tarayıcı ile anlaşması güvenlik kimlik bilgilerini kullanarak oturum durumu deposuna bağlanacak. false, asp.net değil dönmek için işlem kimliği veya uygulama kimliğe bürünme kimlik oturum durumu depo. bağlanırken Daha fazla bilgi için bkz. ASP.NET Kişiliğe Bürünme. Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan, true değeridir. Not İçinde.net Framework sürüm 1.1, mode özniteliği ayarlandığı ,SQLServerve istemcinin kimliğe bürünme özelliğinin etkin, asp.net ile ASP'den istemcinin kimlik bilgilerini kullanarak sql Server çalıştıran bilgisayara bağlı.net istemci kimliğe bürünme.
Devralınan öznitelikler	İsteğe bağlı öznitelikler. Tüm bölüm ögeleri tarafından devralınan öznitelikler.

Alt Öğeler

Öge	Açyklama
providers	Özel oturum durumu depo sağlayıcıları koleksiyonunu içerir.

Üst Öğeler

Öge	Açyklama
configuration	Ortak dil çalıştırma modülü ile .NET Framework temelli uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir.
system.web	Kök öğe için asp belirtir.net yapılandırma ayarları, bir yapılandırma dosyası ve asp yapılandırma öğeleri içerir.net Web uygulamalarý ve uygulamaları nasıl davranacağını denetler.

Açıklamalar

<sessionState> Öğesi için geçerli uygulamanın oturum durumu ayarlarını yapılandırır

Yeni bir istemci, bir Web uygulaması ile etkileşim başladığında, oturum kimliği verilen ve izleyen tüm istekler aynı istemci oturumu geçerli olmakla ilişkili. Bu kimlik, isteklerini arasında istemci oturum ile ilişkili olan sunucu tarafı saklamak için kullanılır. <sessionState> Öğe denetimleri nasıl asp.net uygulama kurar ve bu ilişki için her istemci. tutar

Bu mekanizma, oldukça esnektir ve işlem dışı oturum durumu bilgilerini barındıran ve diğer öğelerin yanı sıra tanımlama bilgilerini kullanmadan durumunu izlemek sağlar.

Oturum kimliği URI gönderdiğinizde URI boyutu üst sınırı aşabilir. Anonim kimlik bileti, kimlik doğrulaması bileti, oturum kimliği ve kullanıcı verileri birleşimi en fazla izin verilen URI uzunluğundan daha büyükse, 400-Bad Request hatası ile başarısız olur.

StateServer modunu kullanmak için

Emin olun, oturum durumu bilgilerinin depolanacağı uzak sunucuda asp.net durum hizmeti çalışıyor.

asp.net state servisi, asp ile yüklenir.net ve varsayılan olarak % windir%\Microsoft.NET\Framework\version\aspnet_state.exe bulunur.
Uygulamanın Web.config dosyasında mode için "StateServer" ve stateConnectionString bir değer gibi "tcpip=dataserver:42424".

SQLServer modunu kullanmak için

Oturum durumunu depolar sql Server çalıştıran bilgisayarda InstallSqlState.SQL işlemini çalıştırın.

Varsayılan olarak, InstallSqlState.SQL içinde % windir%\Microsoft.NET\Framework\version ' dir.

Bu yeni saklı yordamlar ve tablolar TempDB veritabanında ASPStateTempApplications ile ASPStateTempSessions adlı ASPState adlı bir veritabanı oluşturur.
Uygulamanın Web.config dosyasında mode için "SQLServer" ve sqlConnectionString bir değer gibi "data source=localhost;Integrated Security=SSPI;".

Not

Bu adımları tamamlamak için Aspnet_regsql.exe kullanabilirsiniz.

Not
Bu adımları tamamlamak için Aspnet_regsql.exe kullanabilirsiniz.

Uygulama kodundaki <sessionState> ögesi için yapılandırma değerlerine erişme ve onları değiştirme hakkında daha fazla bilgi için bkz. SessionStateSection ve System.Web.SessionState.

Varsayılan Yapılandırma

Aşağıdaki varsayılan <sessionState> ögesi Machine.config dosyası veya kök Web.config dosyasında tam olarak yapılandırılmamıştır. Ancak bu, uygulamanın varsayılan yapılandırmasıdır.

<sessionState 
   mode="InProc" 
   stateConnectionString="tcpip=127.0.0.1:42424" 
   stateNetworkTimeout="10" 
   sqlConnectionString="data source=127.0.0.1;Integrated Security=SSPI" 
   sqlCommandTimeout="30" 
   customProvider="" 
   cookieless="UseCookies" 
   cookieName="ASP.NET_SessionId" 
   timeout="20" 
   allowCustomSqlDatabase="false" 
   regenerateExpiredSessionId="true" 
   partitionResolverType="" 
   useHostingIdentity="true">
   <providers>
      <clear />
   </providers>
</sessionState>

Örnek

Aşağıdaki örnek, oturum durumu yapılandırma ayarları belirtmek gösterilmiştir.

<sessionState
   mode="SQLServer"
   cookieless="true"
   sqlConnectionString=" Integrated Security=SSPI;data source=MySqlServer;"
   sqlCommandTimeout="10" />

Öğe Bilgileri

Yapılandırma bölümü işleyicisi	SessionStateSection
Yapılandırma üyesi	System.Web.SessionState
Yapılandırılabilir konumlar	Machine.config Kök düzeyinde Web.config Uygulama düzeyinde Web.config
Gereksinimler	Microsoft Internet Information Services sürüm 5.0, 5.1 ve 6.0 ..NET Framework sürüm 1.0, 1.1 ve 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Aracılığıyla paylaş