Element roleManager Element (ASP.Schemat ustawień netto)

Artykuł
06/25/2012

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Konfiguruje aplikację do zarządzania rolami.

Ten element jest nowego w.NET Framework w wersji 2.0.

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne dla tej sekcji.

Atrybuty

Atrybut	Opis
cacheRolesInCookie	Opcjonalny Boolean atrybut. Określa, że podczas sprawdzania, czy użytkownik jest w szczególności roli, plik cookie jest sprawdzane przed sprawdzanie listy ról u źródła danych przy użyciu dostawcy roli. Jeśli true, wykaz nazw ról w pliku cookie są buforowane dla bieżącego użytkownika; w przeciwnym razie false. Wartością domyślną jest false.
cookieName	Opcjonalny String atrybut. Określa nazwę pliku cookie, w którym przechowywane są nazwy roli. Wartością domyślną jest ".ASPXROLES".
cookiePath	Opcjonalny String atrybut. Ścieżka do pliku cookie nazwy roli. Wartością domyślną jest "/".
cookieProtection	Opcjonalny CookieProtection atrybut. Określa jedną z CookieProtection wartości wyliczenia. Wartością domyślną jest All wartości.
cookieRequireSSL	Opcjonalny Boolean atrybut. Określa, czy plik cookie nazwy roli wymaga protokołu SSL, za setn do serwera. Jeśli ustawiona na true, pliki cookie nazwy roli wymaga protokołu SSL do wysłania do serwera. Wartością domyślną jest false.
cookieSlidingExpiration	Opcjonalny Boolean atrybut. Określa, czy data wygaśnięcia i czasu plików cookie nazwy roli zostaną zresetowane okresowo. Jeśli ustawiona na true, wygaśnięcia pliku cookie będzie na początku należy ustawić bieżącą datę i godzinę plus CookieTimeout wartość w minutach. Podczas gdy użytkownik nadal aktywnie programu ASP.NET aplikacji, Data wygaśnięcia i czasu pliku cookie jest automatycznie aktualizowane, jeśli mniej niż połowa CookieTimeout wartość pozostałych. Aby uzyskać więcej informacji, zobacz Expires. Wartością domyślną jest true.
cookieTimeout	Opcjonalny Int32 atrybut. Liczba minut przed cookie nazwy roli wygasa. Wartością domyślną jest "30" (w minutach).
createPersistentCookie	Opcjonalny Boolean atrybut. Określa, czy plik cookie nazwy roli cookie sesji; plik cookie jest, utracone po zamknięciu przeglądarki. Po ustawieniu true, plik cookie nazwy roli jest trwały plik cookie, który jest dostępny w wielu sesjach przeglądarki. Trwały plik cookie wygaśnięcia daty i godziny są ustawione do bieżącej daty i godziny plus CookieTimeout wartość w minutach. Wartością domyślną jest false.
defaultProvider	Opcjonalny String atrybut. Nazwa domyślnego dostawcy roli. Aby uzyskać więcej informacji, zobacz Provider. Wartością domyślną jest "AspNetSqlRoleProvider".
domain	Opcjonalny String atrybut. Określa Domain wartość cookie nazwy roli. Wartością domyślną jest HttpCookie właściwości domyślne, w którym jest ciąg pusty ("").
enabled	Opcjonalny Boolean atrybut. Określa, czy należy włączyć zarządzanie rolami. Po ustawieniu true, zarządzanie roli jest włączone. Wartością domyślną jest false w pliku Machine.config.
maxCachedResults	Opcjonalny Int32 atrybut. Określa maksymalną liczbę nazw ról, które są buforowane w pliku cookie ról. Wartością domyślną jest 25.
Atrybuty dziedziczone	Opcjonalne atrybuty. Atrybuty dziedziczone przez wszystkie section elementy. Aby uzyskać więcej informacji, zobacz Atrybuty ogólne dziedziczone przez elementy sekcji.

Elementy podrzędne

Element	Opis
providers	Opcjonalnego elementu. Określa zbiór dostawcami ról do zarządzania rolami.

providers

Opcjonalnego elementu.

Określa zbiór dostawcami ról do zarządzania rolami.

Elementy nadrzędne

Element	Opis
configuration	Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji.
system.web	Określa element główny dla aplikacji ASP.Sekcja konfiguracji netto.

Uwagi

roleManager Element konfiguruje aplikacji do zarządzania rolami.

Informacje dotyczące uzyskiwania dostępu do i modyfikowanie wartości konfiguracji roleManager elementem kodu aplikacji, zobacz RoleManagerSection.

Domyślna konfiguracja

Następujące domyślne roleManager element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest konfiguracji domyślnej, która jest zwracana przez aplikację. Dostawcy są jawnie skonfigurowane w pliku 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>

Przykład

Poniższy przykład kodu pokazuje, jak skonfigurować aplikację ASP.NET do korzystania SqlRoleProvider klasy do przechowywania i pobierania informacji o roli.

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

Informacje o elementach

Program obsługi sekcji konfiguracji	RoleManagerSection
Członkowskie konfiguracji	RoleManager
Lokalizacje konfigurowalne	Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config
Wymagania	Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Udostępnij za pośrednictwem

Element roleManager Element (ASP.Schemat ustawień netto)

Atrybuty i elementy

Atrybuty

Elementy podrzędne

Elementy nadrzędne

Uwagi

Domyślna konfiguracja

Przykład

Informacje o elementach

Zobacz też

Zadania

Informacje

Koncepcje

Inne zasoby

Dodatkowe zasoby