Roles.CacheRolesInCookie Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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; }
static member CacheRolesInCookie : bool
Public Shared ReadOnly Property CacheRolesInCookie As Boolean
Wartość właściwości
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 CacheRolesInCookietrue
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.