Sdílet prostřednictvím

Element httpRuntime (schéma nastavení ASP.NET)

  • Článek

Konfiguruje aplikaci pro správu rolí.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské elementy pro tento oddíl.

v případě vícehodnotových atributů

Atribut

Popis

cacheRolesInCookie

Volitelný Boolean atributu.

Určuje, že při ověření, zda je uživatel je v určité roli, je soubor cookie zkontrolován před použitím poskytovatele rolí pro kontrolu seznamu rolí datového zdroje. V případě true je seznam názvů rolí v souboru cookie uložen do mezipaměti pro aktuálního uživatele. Jinak false.

Výchozí hodnota je false.

cookieName

Nepovinný atribut String.

Určuje název souboru cookie, ve kterém jsou uloženy názvy rolí.

Výchozí hodnota je ".ASPXROLES".

cookiePath

Volitelný String atributu.

Cesta souboru cookie s názvy rolí.

Výchozí hodnota je "/".

cookieProtection

Volitelný CookieProtection atributu.

Určuje jednu z následujících výčtových hodnot CookieProtection:

Výchozí hodnota je All.

cookieRequireSSL

Nepovinný atribut Boolean.

Určuje, zda soubor cookie s názvy rolí vyžaduje protokol SSL pro odeslání na server.

Pokud je nastaven na true, vyžadují soubory cookie s názvy rolí protokol SSL pro odeslání na server.

Výchozí hodnota je false.

cookieSlidingExpiration

Nepovinný atribut Boolean.

Určuje, zda datum a čas vypršení souboru cookie s názvy rolí bude pravidelně obnoveno.

Pokud je nastaven na true, je vypršení platnosti souboru zpočátku nastaveno na aktuální datum a čas plus hodnotu CookieTimeout v minutách. Zatímco uživatel aktivně používá aplikaci technologie ASP.NET, datum a čas vypršení souboru cookie je automaticky aktualizován, pokud je menší než polovina zbývající hodnoty CookieTimeout. Další informace naleznete v tématu Expires.

Výchozí hodnota je true.

cookieTimeout

Nepovinný atribut Int32.

Počet minut před vypršením souboru cookie s názvy rolí.

Výchozí hodnota je "30" (minut).

createPersistentCookie

Nepovinný atribut Boolean.

Určuje, zda soubor cookie s názvy rolí je soubor cookie relace. To znamená, že soubor cookie je ztracen při zavření prohlížeče.

V případě true je soubor cookie s názvy rolí trvalý soubor cookie, který je k dispozici v rámci více relací prohlížeče. Datum a čas vypršení trvalého souboru cookie je nastaveno na aktuální datum a čas plus hodnotu CookieTimeout, v minutách.

Výchozí hodnota je false.

defaultProvider

Nepovinný atribut String.

Název výchozího poskytovatele rolí. Další informace naleznete v tématu Provider.

Výchozí hodnota je "AspNetSqlRoleProvider".

domain

Nepovinný atribut String.

Určuje hodnotu Domain souboru cookie s názvy rolí.

Ve výchozím nastavení je vlastnost HttpCookie nastavena na hodnotu prázdného řetězce.

enabled

Nepovinný atribut Boolean.

Určuje, zda chcete povolit správu rolí.

Při nastavení na true je správa rolí povolena.

Výchozí hodnota v souboru Machine.config je false.

maxCachedResults

Nepovinný atribut Int32.

Určuje maximální počet názvů rolí, které jsou uloženy v mezipaměti v souboru cookie s rolemi.

Výchozí hodnota je 25.

Zděděné atributy

Volitelné atributy.

Atributy, které jsou děděny všemi prvky oddílu section. Další informace naleznete v tématu Obecné atributy, které jsou děděny všemi prvky oddílu.

Podřízené prvky

Prvek

Popis

providers

Volitelný prvek.

Definuje kolekci zprostředkovatelů rolí pro správu rolí.

Nadřazené prvky

Prvek

Popis

configuration

Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.

system.web

Určuje kořenový element oddílu konfigurace technologie ASP.NET.

Poznámky

Element roleManager konfiguruje aplikaci pro správu rolí.

Informace o přístupu a změnách hodnot konfigurace elementu roleManager z kódu aplikace, naleznete v RoleManagerSection.

Výchozí konfigurace

Následující výchozí element roleManager není explicitně nakonfigurován v souboru Machine.config nebo v kořenovém souboru web.config. To je však výchozí konfigurace, kterou vrací aplikace. Zprostředkovatelé jsou explicitně konfigurováni v souboru Machine.config.

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

Příklad

Následující příklad ukazuje konfiguraci technologie ASP.NET pro použití třídy SqlRoleProvider k ukládání a načítání informací o rolích.

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

Informace prvku

Obslužná rutina konfiguračního oddílu

RoleManagerSection

Konfigurační člen

RoleManager

Konfigurovatelná umístění

Machine.config

Web.config kořenové úrovně

Web.config aplikační úrovně

Požadavky

Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0

.NET Framework verze 2.0

Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Úkoly

Postup: Konfigurace specifických adresářů pomocí nastavení místa

Postupy: Uzamknutí nastavení konfigurace technologie ASP.NET

Odkaz

Element system.web (schéma nastavení ASP.NET)

Podelement providers elementu roleManager (schéma nastavení ASP.NET)

Element configuration (schéma obecného nastavení)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Koncepty

Principy správy rolí

Zabezpečení konfigurace technologie ASP.NET

Scénáře konfigurace technologie ASP.NET

Další zdroje

Obecné nastavení konfigurace (technologie ASP.NET)

Nastavení konfigurace ASP.NET

Reference ASP.NET

Správa webu ASP.NET

Rozhraní API konfigurace technologie ASP.NET