Element add podelementu providers elementu roleManager (schéma nastavení ASP.NET)

Článek
08/11/2011

Přidá instanci poskytovatele rolí do kolekce poskytovatelů správy rolí.

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

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

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

Atribut	Popis
applicationName	Volitelný String atributu. Určuje název aplikace, pod jejímž jménem jsou uloženy názvy rolí ve zdroji dat. Název aplikace umožňuje používat stejnou databázi více aplikacemi ASP.NET bez výskytu duplicitních jmen rolí pro různé aplikace. Eventuálně, více aplikací technologie ASP.NET může použít stejné informace o rolích zadáním stejného názvu aplikace. Poskytovatelé rolí, kteří jsou součástí rozhraní .NET Framework, používají hodnotu ApplicationVirtualPath pro vlastnost ApplicationName, pokud není tento atribut určen.
cacheRefreshInterval	Nepovinný atribut Int32. Určuje počet minut mezi vynucenými aktualizacemi uložených dat zásad mezipaměti a aplikuje se pouze na AuthorizationStoreRoleProvider. Výchozí hodnota je 60.
commandTimeout	Nepovinný atribut Int32. Určuje počet sekund před vypršením příkazu vydanému datovému zdroji správce rolí. Tento časový limit používá poskytovatel SQL při vytváření objektů SqlCommand. Ve výchozím nastavení konfigurace technologie ASP.NET není tento atribut nastaven. Výsledkem je použití výchozích 30 sekund technologie rozhraní ADO.NET. Pokud je tento atribut nastaven, použije poskytovatel SQL nakonfigurovanou hodnotu časového limitu pro všechny SQL příkazy volané na databázi. Výchozí hodnota je 30 (výchozí hodnota rozhraní ADO.NET).
connectionStringName	Požadovaný atribut typu String. Určuje název připojovacího řetězce, který je definován v elementu <connectionStrings>. Zadaný připojovací řetězec bude použit přidávaným poskytovatelem.
description	Nepovinný atribut String. Určuje popis instance poskytovatele rolí.
name	Požadovaný atribut typu String. Určuje název instance poskytovatele. Jedná se o hodnotu, která se používá pro atribut defaultProvider elementu <roleManager> k identifikaci instance poskytovatele jako výchozího poskytovatele rolí. name poskytovatele je také použito k indexaci poskytovatele v kolekci Providers.
scopeName	Nepovinný atribut String. Určuje rozsah zabezpečení úložiště zásad správce autorizací, ke kterému by se měla instance poskytovatele připojit a platí pouze pro AuthorizationStoreRoleProvider. Pokud není scopeName zadán, je zprostředkovatelem použita kombinace applicationName a scopeName při připojování k úložišti zásad.
type	Požadovaný atribut typu String. Určuje typ, který implementuje základní abstraktní třídu RoleProvider.

Podřízené prvky

Žádný

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.
roleManager	Konfiguruje aplikaci pro správu rolí.
providers	Definuje kolekci zprostředkovatelů rolí pro správu rolí.

Poznámky

Element add přidá instanci poskytovatele rolí do kolekce poskytovatelů správy rolí uložených v elementu providers.

Element providers definuje kolekci poskytovatelů rolí pro správu rolí.

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

Výchozí konfigurace

Následující výchozí element providers je konfigurován v souboru Machine.config.

<roleManager>
   <providers>
<add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" 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	Add
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é

Sdílet prostřednictvím

Element add podelementu providers elementu roleManager (schéma nastavení ASP.NET)

Atributy a prvky

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

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály