Roles.Providers Propriété

  • Référence

Définition

Espace de noms:
System.Web.Security
Assembly:
System.Web.dll

Obtient une collection de fournisseurs de rôles pour l’application ASP.NET.

public:
 static property System::Web::Security::RoleProviderCollection ^ Providers { System::Web::Security::RoleProviderCollection ^ get(); };
public static System.Web.Security.RoleProviderCollection Providers { get; }
static member Providers : System.Web.Security.RoleProviderCollection
Public Shared ReadOnly Property Providers As RoleProviderCollection

Valeur de propriété

RoleProviderCollection

RoleProviderCollection contenant les fournisseurs de rôles configurés pour l'application ASP.NET.

Exceptions

ProviderException

La gestion des rôles n'est pas activée.

Exemples

L’exemple de code suivant répertorie les fournisseurs activés pour une application et leurs types respectifs.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Configuration.Provider" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>List Enabled Providers</title>
</head>
<body>

<%
foreach (RoleProvider p in Roles.Providers)
  Response.Write(p.Name + ", " + p.GetType() + "<br />");
%>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Configuration.Provider" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>List Enabled Providers</title>
</head>
<body>

<%
For Each p As RoleProvider In Roles.Providers
  Response.Write(p.Name & ", " & p.GetType().ToString() & "<br />")
Next
%>

</body>
</html>

Remarques

La Providers propriété référence tous les fournisseurs de rôles activés pour une application, y compris tous les fournisseurs ajoutés dans le fichier Web.config. Vous pouvez contrôler les fournisseurs de rôles disponibles pour une application à l’aide de l’élément providers de la section roleManager dans le fichier Web.config de votre application.

L’exemple suivant montre une section roleManager qui supprime tous les fournisseurs existants (tels que ceux spécifiés dans le fichier Machine.config) et ajoute une SqlRoleProvider instance en tant que fournisseur de rôle pour l’application.

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

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

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

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

Vous pouvez obtenir une référence fortement typée à un fournisseur à partir de la Providers collection en indexant le fournisseur de rôle par son nom et en le castant comme type souhaité.

Vous pouvez obtenir une référence au fournisseur par défaut pour une application à l’aide de la Provider propriété .

S’applique à

Voir aussi