Freigeben über

Roles.Providers Eigenschaft

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Ruft eine Auflistung der Rollenanbieter für die ASP.NET Anwendung ab.

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

Eigenschaftswert

RoleProviderCollection

A RoleProviderCollection that contains the role providers configured for the ASP.NET application.

Ausnahmen

ProviderException

Die Rollenverwaltung ist nicht aktiviert.

Beispiele

Im folgenden Codebeispiel werden die anbieter aufgeführt, die für eine Anwendung und ihre jeweiligen Typen aktiviert sind.

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

Hinweise

Die Providers Eigenschaft verweist auf alle Rollenanbieter, die für eine Anwendung aktiviert sind, einschließlich aller Anbieter, die in der datei Web.config hinzugefügt wurden. Sie können steuern, welche Rollenanbieter für eine Anwendung verfügbar sind, indem Sie das providers Element des RoleManager-Abschnitts in der Web.config Datei für Ihre Anwendung verwenden.

Das folgende Beispiel zeigt einen RoleManager-Abschnitt , der vorhandene Anbieter (z. B. die in der datei Machine.config angegeben) entfernt und eine SqlRoleProvider Instanz als Rollenanbieter für die Anwendung hinzufügt.

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

Sie können einen stark typierten Verweis auf einen Anbieter aus der Providers Auflistung abrufen, indem Sie den Rollenanbieter anhand des Namens indizieren und ihn als gewünschten Typ umwandeln.

Sie können einen Verweis auf den Standardanbieter für eine Anwendung mithilfe der Provider Eigenschaft abrufen.

Gilt für:

Weitere Informationen