RoleProvider RoleProvider RoleProvider RoleProvider Class

Definition

Definiert den Vertrag, den ASP.NET implementiert, um Rollenverwaltungsdienste unter Verwendung benutzerdefinierter Rollenanbieter bereitzustellen.Defines the contract that ASP.NET implements to provide role-management services using custom role providers.

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

Hinweise

ASP.NET-Rollenverwaltung wurde entwickelt, damit Sie problemlos eine Anzahl von Anbietern für andere Rolle für Ihre ASP.NET-Anwendungen verwenden können.ASP.NET role management is designed to enable you to easily use a number of different role providers for your ASP.NET applications. Können Sie die angegebene Rolle-Anbieter, die mit .NET Framework enthalten sind, oder Sie können Ihren eigenen Anbieter implementieren.You can use the supplied role providers that are included with the .NET Framework, or you can implement your own provider.

Wenn Sie einen benutzerdefinierten Rollenanbieter implementieren zu können, müssen Sie erben die RoleProvider abstrakte Klasse.When implementing a custom role provider, you are required to inherit the RoleProvider abstract class.

Es gibt zwei Hauptgründe für das Erstellen eines benutzerdefinierten Rollenanbieters.There are two primary reasons for creating a custom role provider.

  • Sie müssen Informationen in einer Datenquelle zu speichern, die von den Rollenanbieter in .NET Framework, z. B. einer FoxPro-Datenbank, eine Oracle-Datenbank oder anderen Datenquellen enthalten nicht unterstützt wird.You need to store role information in a data source that is not supported by the role providers included with the .NET Framework, such as a FoxPro database, an Oracle database, or other data sources.

  • Sie müssen zum Verwalten von Rolleninformationen mit einem Datenbankschema, das das Datenbankschema, die der Anbieter aus dem Lieferumfang von .NET Framework unterscheiden.You need to manage role information using a database schema that is different from the database schema used by the providers that ship with the .NET Framework. Ein gängiges Beispiel hierfür wäre Daten der Rolle, die in SQL Server-Datenbank für ein Unternehmen oder die Website bereits vorhanden ist.A common example of this would be role data that already exists in a SQL Server database for a company or Web site.

Konstruktoren

RoleProvider() RoleProvider() RoleProvider() RoleProvider()

Initialisiert eine neue Instanz der RoleProvider-Klasse.Initializes a new instance of the RoleProvider class.

Eigenschaften

ApplicationName ApplicationName ApplicationName ApplicationName

Ruft den Namen der Anwendung ab, für die Rolleninformationen gespeichert und abgerufen werden sollen, oder legt diesen fest.Gets or sets the name of the application to store and retrieve role information for.

Description Description Description Description

Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)

Methoden

AddUsersToRoles(String[], String[]) AddUsersToRoles(String[], String[]) AddUsersToRoles(String[], String[]) AddUsersToRoles(String[], String[])

Fügt die angegebenen Benutzernamen den angegebenen Rollen der konfigurierten applicationName hinzu.Adds the specified user names to the specified roles for the configured applicationName.

CreateRole(String) CreateRole(String) CreateRole(String) CreateRole(String)

Fügt eine neue Rolle zur Datenquelle für die konfigurierte applicationName hinzu.Adds a new role to the data source for the configured applicationName.

DeleteRole(String, Boolean) DeleteRole(String, Boolean) DeleteRole(String, Boolean) DeleteRole(String, Boolean)

Entfernt eine Rolle aus der Datenquelle für die konfigurierte applicationName.Removes a role from the data source for the configured applicationName.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindUsersInRole(String, String) FindUsersInRole(String, String) FindUsersInRole(String, String) FindUsersInRole(String, String)

Ruft ein Array von Benutzernamen in einer Rolle ab, die mit den angegebenen Benutzernamen übereinstimmen.Gets an array of user names in a role where the user name contains the specified user name to match.

GetAllRoles() GetAllRoles() GetAllRoles() GetAllRoles()

Ruft eine Liste aller Rollen für die konfigurierte applicationName ab.Gets a list of all the roles for the configured applicationName.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetRolesForUser(String) GetRolesForUser(String) GetRolesForUser(String) GetRolesForUser(String)

Ruft eine Liste der Rollen für einen angegebenen Benutzer für das konfigurierte applicationName ab.Gets a list of the roles that a specified user is in for the configured applicationName.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetUsersInRole(String) GetUsersInRole(String) GetUsersInRole(String) GetUsersInRole(String)

Ruft eine Liste der Benutzer mit der angegebenen Rolle für die konfigurierte applicationName ab.Gets a list of users in the specified role for the configured applicationName.

Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Initialisiert den Konfigurations-Generator.Initializes the configuration builder.

(Inherited from ProviderBase)
IsUserInRole(String, String) IsUserInRole(String, String) IsUserInRole(String, String) IsUserInRole(String, String)

Ruft einen Wert ab, der angibt, ob der angegebene Benutzer die angegebene Rolle für den konfigurierten applicationName innehat.Gets a value indicating whether the specified user is in the specified role for the configured applicationName.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveUsersFromRoles(String[], String[]) RemoveUsersFromRoles(String[], String[]) RemoveUsersFromRoles(String[], String[]) RemoveUsersFromRoles(String[], String[])

Entfernt die angegebenen Benutzernamen aus den angegebenen Rollen der konfigurierten applicationName.Removes the specified user names from the specified roles for the configured applicationName.

RoleExists(String) RoleExists(String) RoleExists(String) RoleExists(String)

Ruft einen Wert ab, der angibt, ob der angegebene Rollenname bereits in der Rollendatenquelle für die konfigurierte applicationName vorhanden ist.Gets a value indicating whether the specified role name already exists in the role data source for the configured applicationName.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch