Roles.Providers Eigenschaft

  • Referenz

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

Eine RoleProviderCollection, die die für die ASP.NET-Anwendung konfigurierten Rollenanbieter enthält.

Ausnahmen

ProviderException

Rollenverwaltung ist nicht aktiviert.

Beispiele

Im folgenden Codebeispiel werden die für eine Anwendung aktivierten Anbieter und deren jeweiligen Typen aufgelistet.

<%@ 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 für eine Anwendung aktivierten Rollenanbieter, einschließlich aller Anbieter, die in der Web.config-Datei hinzugefügt wurden. Sie können steuern, welche Rollenanbieter für eine Anwendung verfügbar sind, indem Sie das providers Element des Abschnitts roleManager in der Web.config-Datei für Ihre Anwendung verwenden.

Das folgende Beispiel zeigt einen roleManager-Abschnitt , der alle vorhandenen Anbieter (z. B. die in der Machine.config-Datei angegebenen) 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 typisierten Verweis auf einen Anbieter aus der Providers Auflistung abrufen, indem Sie den Rollenanbieter nach Name indizieren und ihn als gewünschten Typ umwandeln.

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

Gilt für:

Weitere Informationen