Roles.CacheRolesInCookie Właściwość

Definicja

Pobiera wartość wskazującą, czy role bieżącego użytkownika są buforowane w pliku cookie.

public:
 static property bool CacheRolesInCookie { bool get(); };
public static bool CacheRolesInCookie { get; }
member this.CacheRolesInCookie : bool
Public Shared ReadOnly Property CacheRolesInCookie As Boolean

Wartość właściwości

Boolean

true jeśli role bieżącego użytkownika są buforowane w pliku cookie; w przeciwnym razie , false. Wartość domyślna to true.

Przykłady

Poniższy przykład przedstawia element roleManager w system.web sekcji pliku Web.config dla aplikacji ASP.NET. Określa, że aplikacja używa SqlRoleProvider wystąpienia i ustawia cacheRolesInCookie atrybut na true.

<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="MyApplication" />
   </providers>
</roleManager>

Uwagi

Gdy właściwość jest ustawiona CacheRolesInCookie true na wartość w pliku Web.config, informacje o rolach dla każdego użytkownika są przechowywane w pliku cookie. Gdy zarządzanie rolami sprawdza, czy użytkownik znajduje się w określonej roli, plik cookie ról jest sprawdzany przed wywołaniem dostawcy roli w celu sprawdzenia listy ról w źródle danych. Plik cookie jest dynamicznie aktualizowany w celu buforowania ostatnio zweryfikowanych nazw ról.

Niezawodność nazw ról buforowanych w pliku cookie można zwiększyć, określając CookieProtectionValue właściwość podczas konfigurowania ról ASP.NET. Wartość domyślna CookieProtectionValue to All, która szyfruje nazwy ról w pliku cookie i sprawdza, czy zawartość pliku cookie nie została zmieniona.

Uwaga

Ponieważ nazwy ról mogą być buforowane poza źródłem danych, istnieje możliwość, że zmiany zarządzania rolami w źródle danych nie zostaną odzwierciedlone w buforowanych wartościach. W takim przypadku użytkownik musi zamknąć i ponownie otworzyć przeglądarkę, aby wyczyścić wartość buforowanego pliku cookie.

Dotyczy

Zobacz też