Roles Klass

Definition

public ref class Roles abstract sealed

public static class Roles

type Roles = class

Public Class Roles

Arv

Object

Roles

Exempel

I följande exempel visas Web.config-filen för ett program som har konfigurerats för att använda både ASP.NET medlemskap och ASP.NET roller och för att använda SqlRoleProvider för att lagra medlemskaps- och rollinformation i en SQL Server databas. Användare autentiseras med formulärautentisering och endast användare i rollen Administratörer får åtkomst till programmet.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Initial Catalog=aspnetdb;Integrated Security=SSPI;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>

    <authorization>
      <deny users="?" />
      <allow roles="Administrators" />
      <deny users="*" />
    </authorization>

    <membership defaultProvider="AspNetSqlProvider" userIsOnlineTimeWindow="15">
    </membership>

    <roleManager defaultProvider="SqlProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="true"
      cookieSlidingExpiration="true"
      cookieProtection="All" >

      <providers>
        <clear />
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices"
          applicationName="SampleApplication" />
        </providers>

    </roleManager>
  </system.web>
</configuration>

I följande kodexempel kontrolleras programmatiskt om den inloggade användaren är i rollen Administratörer innan användaren kan visa andra användares roller.

Kommentarer

ASP.NET rollhantering kan du hantera auktorisering för ditt program baserat på grupper av användare, som kallas roller. Genom att tilldela användare till roller kan du styra åtkomsten till olika delar eller funktioner i ditt webbprogram baserat på roll i stället för, eller utöver, att ange auktorisering baserat på användarnamn. Ett medarbetarprogram kan till exempel ha roller som Chefer, Anställda, Direktörer och så vidare, där olika behörigheter anges för varje roll.

Användare kan tillhöra mer än en roll. Om din webbplats till exempel är ett diskussionsforum kan vissa användare ha rollen som både medlemmar och moderatorer. Du kan definiera att varje roll har olika behörigheter på webbplatsen, och en användare som är i båda rollerna skulle då ha båda uppsättningarna med behörigheter.

Om du vill aktivera rollhantering för ditt ASP.NET-program använder du avsnittet roleManager i avsnittet system.web i Web.config-filen för ditt program, som du ser i följande exempel.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Initial Catalog=aspnetdb;Integrated Security=SSPI;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>

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

Du kan ange auktoriseringsregler i konfigurationsfilen för webbprogrammet eller programmatiskt i koden. Följande auktoriseringsavsnitt från en Web.config-fil kräver till exempel att användarna loggar in (genom att neka anonyma användare) och sedan endast tillåter att användare i rollen Administratörer har åtkomst.

<authorization>
  <deny users="?" />
  <allow roles="Administrators" />
  <deny users="*" />
</authorization>

Om du använder authorization avsnittet i programmets Web.config-fil för att ange auktorisering baserat på roller, måste användarna av ditt program ange en autentiserad användaridentitet. Du kan autentisera användare med hjälp av antingen Windows- eller Formulärautentisering. Anonyma användare kan inte tilldelas till en roll. Roller kan användas oberoende av, eller tillsammans med, klasserna ASP.NET Membership.

Om du vill verifiera rollmedlemskap programmatiskt kan du använda Roles -klassen eller Page.User -egenskapen med IsUserInRole -metoden, eller så kan du använda Page.User egenskapen med IPrincipal.IsInRole -metoden. Exempelkod som programmässigt kontrollerar rollmedlemskap finns i avsnittet Exempel i det här avsnittet.

Med Roles klassen kan du också skapa och ta bort roller och lägga till användare i eller ta bort användare från roller.

Du kan lagra rollinformation i flera datakällor.

• Du kan använda klassen WindowsTokenRoleProvider för att hämta rollinformation baserat på medlemskap i Windows grupper.

• Du kan lagra rollinformation i en SQL Server databas med hjälp av klassen SqlRoleProvider.

• Om du har befintlig rollinformation eller vill lagra rollinformation i och hämta rollinformation från en annan datakälla än Windows, ett auktoriseringsarkiv eller SQL Server kan du implementera en anpassad rollprovider genom att skapa en klass som ärver RoleProvider abstrakt klass. Mer information finns i Implementera en rollprovider.

Om en användares webbläsare accepterar cookies kan du lagra rollinformation för användaren i en cookie på användarens dator. På varje sidbegäran läser ASP.NET rollinformationen för användaren från cookien. Detta kan förbättra programmets prestanda genom att minska mängden kommunikation som krävs med datakällan för att hämta rollinformation. Om rollinformationen för en användare är för lång för att lagra i en cookie lagrar ASP.NET bara den senast använda rollinformationen i cookien och letar sedan upp ytterligare rollinformation i datakällan efter behov. Om användarens webbläsare inte stöder cookies eller cookies är inaktiverade cachelagras inte rollinformation i en cookie.

Du kan förbättra tillförlitligheten för rollnamnen som cachelagras i en cookie genom att ange en egenskap CookieProtectionValue när du konfigurerar ASP.NET roller. Standardvärdet CookieProtectionValue är All, som krypterar rollnamn i cookien och verifierar att cookieinnehållet inte har ändrats.

Se även

• Förstå ASP.NET rollhantering