roleManager Ögesi (ASP.NET Ayarlar Şeması)

Makale
08/01/2011

Rol yönetimi için uygulama yapılandırır.

Bu öge .NET Framework sürüm 2.0'da yenidir.

<roleManager
    cacheRolesInCookie="true|false"
    cookieName="name"
    cookiePath="/"
    cookieProtection="All|Encryption|Validation|None"
    cookieRequireSSL="true|false "
    cookieSlidingExpiration="true|false "
    cookieTimeout="number of minutes"
    createPersistentCookie="true|false"
    defaultProvider="provider name"
    domain="cookie domain">
    enabled="true|false"
    maxCachedResults="maximum number of role names cached"
    <providers>...</providers>
</roleManager>

Öznitelikler ve Öğeler

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

Öznitelikler

Öznitelik	Açıklama
cacheRolesInCookie	İsteğe bağlı Boolean özniteliği. Bir kullanıcının belirli bir rolde olduğunu doğrularken, tanımlama bilgisinin veri kaynağındaki rollerin listesini denetlemek için rol sağlayıcısı kullanmadan önce seçili olduğunu belirtir. true ise tanımlama bilgisi rol adları listesi geçerli kullanıcı için önbelleğe alınmıştır; aksi durumda, false'tur. Varsayılan, false değeridir.
cookieName	İsteğe bağlı String özniteliği. Rol adlarının depolandığı tanımlama bilgisinin adını belirtir. Varsayılan, ".ASPXROLES" değeridir.
cookiePath	İsteğe bağlı String özniteliği. Rol adları tanımlama bilgisi yolu. Varsayılan, "/" değeridir.
cookieProtection	İsteğe bağlı CookieProtection özniteliği. CookieProtection sabit listesi değerlerinden birini belirtir. Varsayılan, All değeridir.
cookieRequireSSL	İsteğe bağlı Boolean özniteliği. Rol adları tanımlama bilgisinin sunucuya gönderilmesi için SSL'in gerekip gerekmediğini belirtir. true olarak ayarlanmışsa, rol adları tanımlama bilgilerinin sunucuya gönderilmesi için SSL gerekir. Varsayılan, false değeridir.
cookieSlidingExpiration	İsteğe bağlı Boolean özniteliği. Rol adları tanımlama bilgisinin süre sonu tarihi ve saatinin düzenli aralıklarla sıfırlanıp sıfırlanmayacağını belirtir. true olarak ayarlanmışsa, tanımlama bilgisinin süre sonu ilk olarak dakika cinsinden güncel tarih ve saat artı CookieTimeout değerine ayarlanır. Kullanıcı, ASP.NET uygulaması kullanımına etkin biçimde devam ederken CookieTimeout değerinin yarısından daha azı kaldıysa tanımlama bilgisinin süre sonu tarihi ve saati otomatik olarak güncelleştirilir. Daha fazla bilgi için bkz. Expires. Varsayılan, true değeridir.
cookieTimeout	İsteğe bağlı Int32 özniteliği. Rol adları tanımlama bilgisinin süre bitmeden önce kalan dakikası. Varsayılan değer "30" dakikadır.
createPersistentCookie	İsteğe bağlı Boolean özniteliği. Rol adları tanımlama bilgisinin oturum tanımlama bilgisi olup olmadığını belirtir; yani tarayıcı kapatıldığında tanımlama bilgisi kaybolur. true olarak ayarlandığında rol adları tanımlama bilgisi birden çok tarayıcı oturumu tarafından kullanılabilir olan kalıcı bir tanımlama bilgisi olur. Kalıcı tanımlama bilgisinin süre sonu tarih ve saati, dakika cinsinden güncel tarih ve saat artı CookieTimeout değerine ayarlanır. Varsayılan, false değeridir.
defaultProvider	İsteğe bağlı String özniteliği. Varsayılan rol sağlayıcısı adı. Daha fazla bilgi için bkz. Provider. Varsayılan, "AspNetSqlRoleProvider" değeridir.
domain	İsteğe bağlı String özniteliği. Rol adları tanımlama bilgisinin Domain değerini belirtir. Varsayılan değer, boş bir dize olan ("") HttpCookie özelliği varsayılanıdır.
enabled	İsteğe bağlı Boolean özniteliği. Rol yönetiminin etkinleştirilip etkinleştirilmeyeceğini belirtir. true olarak ayarlandığında rol yönetimi etkindir. Varsayılan değer Machine.config dosyasındaki false değeridir.
maxCachedResults	İsteğe bağlı Int32 özniteliği. Rolleri tanımlama bilgisinde önbelleğe alınan rol adlarının maksimum sayısını belirtir. Varsayılan, 25 değeridir.
Devralınan öznitelikler	İsteğe bağlı öznitelikler. Tüm section ögeleri tarafından devralınan öznitelikler. Daha fazla bilgi için bkz. Bölüm Ögeleri Tarafından Devralınan Genel Öznitelikler.

Alt Öğeler

Öge	Açıklama
providers	İsteğe bağlı öğe. Rol yönetimi için rol sağlayıcıları koleksiyonu tanımlar.

providers

İsteğe bağlı öğe.

Rol yönetimi için rol sağlayıcıları koleksiyonu tanımlar.

Üst Öğeler

Öge	Açıklama
configuration	Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir.
system.web	ASP.NET yapılandırma bölümünün kök ögesini belirler.

Açıklamalar

roleManager ögesi rol yönetimi için uygulama yapılandırır.

Uygulama kodundaki roleManager ögesi için yapılandırma değerlerine erişme ve onları değiştirme hakkında daha fazla bilgi için bkz. RoleManagerSection.

Varsayılan Yapılandırma

Aşağıdaki varsayılan roleManager ö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. Sağlayıcılar, Machine.config dosyasında açık olarak yapılandırılır.

<roleManager 
   enabled="false" 
   cacheRolesInCookie="false" 
   cookieName=".ASPXROLES" 
   cookieTimeout="30" 
   cookiePath="/" 
   cookieRequireSSL="false" 
   cookieSlidingExpiration="true" 
   cookieProtection="All" 
   defaultProvider="AspNetSqlRoleProvider" 
   createPersistentCookie="false" 
   maxCachedResults="25">
   <providers>
      <clear />
      <add 
         connectionStringName="LocalSqlServer" 
         applicationName="/" 
         name="AspNetSqlRoleProvider" 
         type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
      <add 
         applicationName="/" 
         name="AspNetWindowsTokenRoleProvider" 
         type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
   </providers>
</roleManager>

Örnek

Aşağıdaki kod örneğinde rol bilgisi depolamak ve almak için SqlRoleProvider sınıfını kullanmak üzere bir ASP.NET uygulamasının nasıl yapılandırıldığı gösterilmektedir.

<configuration>
  <system.web>
    <roleManager defaultProvider="SqlProvider" 
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="false"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices" 
          applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

Öğe Bilgileri

Yapılandırma bölümü işleyicisi	RoleManagerSection
Yapılandırma üyesi	RoleManager
Yapılandırılabilir konumlar	Machine.config Kök düzeyinde Web.config Uygulama düzeyinde Web.config
Gereksinimler	Microsoft Internet Information Services (IIS) sürüm 5.0, 5.1 veya 6.0 .NET Framework sürüm 2.0 Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Aracılığıyla paylaş

roleManager Ögesi (ASP.NET Ayarlar Şeması)

Öznitelikler ve Öğeler

Öznitelikler

Alt Öğeler

Üst Öğeler

Açıklamalar

Varsayılan Yapılandırma

Örnek

Öğe Bilgileri

Ayrıca bkz.

Görevler

Başvuru

Kavramlar

Diğer Kaynaklar

Ek kaynaklar