RoleProvider Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert den Vertrag, der ASP.NET implementiert, um Rollenverwaltungsdienste mithilfe von benutzerdefinierten Rollenanbietern bereitzustellen.
public ref class RoleProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class RoleProvider : System.Configuration.Provider.ProviderBase
type RoleProvider = class
inherit ProviderBase
Public MustInherit Class RoleProvider
Inherits ProviderBase
- Vererbung
- Abgeleitet
Hinweise
ASP.NET Rollenverwaltung ist so konzipiert, dass Sie eine Reihe von verschiedenen Rollenanbietern für Ihre ASP.NET Anwendungen problemlos verwenden können. Sie können die bereitgestellten Rollenanbieter verwenden, die im .NET Framework enthalten sind, oder Sie können Ihren eigenen Anbieter implementieren.
Beim Implementieren eines benutzerdefinierten Rollenanbieters müssen Sie die RoleProvider abstrakte Klasse erben.
Es gibt zwei Hauptgründe für das Erstellen eines benutzerdefinierten Rollenanbieters.
Sie müssen Rolleninformationen in einer Datenquelle speichern, die nicht von den Rollenanbietern unterstützt wird, die im .NET Framework enthalten sind, z. B. eine FoxPro-Datenbank, eine Oracle-Datenbank oder andere Datenquellen.
Sie müssen Rolleninformationen mithilfe eines Datenbankschemas verwalten, das sich von dem Datenbankschema unterscheidet, das von den Anbietern verwendet wird, die mit dem .NET Framework ausgeliefert werden. Ein gängiges Beispiel hierfür sind Rollendaten, die bereits in einer SQL Server-Datenbank für ein Unternehmen oder eine Website vorhanden sind.
Konstruktoren
| Name | Beschreibung |
|---|---|
| RoleProvider() |
Initialisiert eine neue Instanz der RoleProvider-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ApplicationName |
Ruft den Namen der Anwendung ab, für die Rolleninformationen gespeichert und abgerufen werden sollen, oder legt diesen fest. |
| Description |
Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet ist. (Geerbt von ProviderBase) |
| Name |
Ruft den Anzeigenamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase) |
Methoden
| Name | Beschreibung |
|---|---|
| AddUsersToRoles(String[], String[]) |
Fügt die angegebenen Benutzernamen zu den angegebenen Rollen für die konfigurierte |
| CreateRole(String) |
Fügt der Datenquelle für die konfigurierte |
| DeleteRole(String, Boolean) |
Entfernt eine Rolle aus der Datenquelle für die konfigurierte |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindUsersInRole(String, String) |
Ruft ein Array von Benutzernamen in einer Rolle ab, in der der Benutzername den angegebenen Benutzernamen enthält, der übereinstimmen soll. |
| GetAllRoles() |
Ruft eine Liste aller Rollen für die konfigurierte |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetRolesForUser(String) |
Ruft eine Liste der Rollen ab, in denen ein angegebener Benutzer für die konfiguriert ist |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUsersInRole(String) |
Ruft eine Liste der Benutzer in der angegebenen Rolle für die konfigurierte |
| Initialize(String, NameValueCollection) |
Initialisiert den Konfigurations-Generator. (Geerbt von ProviderBase) |
| IsUserInRole(String, String) |
Ruft einen Wert ab, der angibt, ob der angegebene Benutzer in der angegebenen Rolle für die konfigurierte . |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| RemoveUsersFromRoles(String[], String[]) |
Entfernt die angegebenen Benutzernamen aus den angegebenen Rollen für die konfigurierte |
| RoleExists(String) |
Ruft einen Wert ab, der angibt, ob der angegebene Rollenname bereits in der Rollendatenquelle für die konfigurierte |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |