ProfileProvider 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 Profildienste mithilfe von benutzerdefinierten Profilanbietern bereitzustellen.
public ref class ProfileProvider abstract : System::Configuration::SettingsProvider
public abstract class ProfileProvider : System.Configuration.SettingsProvider
type ProfileProvider = class
inherit SettingsProvider
Public MustInherit Class ProfileProvider
Inherits SettingsProvider
- Vererbung
- Abgeleitet
Beispiele
Ein Beispiel für eine ProfileProvider Implementierung finden Sie unter How to: Build and Run the Profile Provider Example.
Hinweise
ASP.NET Profile bieten beständigen Speicher und Abruf von benutzerspezifischen Eigenschaften. Profileigenschaftenwerte und -informationen werden in einer Datenquelle auf eine Weise gespeichert, die durch die ProfileProvider Implementierung bestimmt wird. Sie können die Profilanbieter verwenden, die im .NET Framework enthalten sind (dargestellt durch die Klassen, die von der abstrakten Klasse ProfileProvider abgeleitet sind), oder Sie können Ihren eigenen Anbieter implementieren, indem Sie eine neue Klasse erstellen, die von ProfileProvider abgeleitet wird.
Es gibt zwei Hauptgründe für das Erstellen eines benutzerdefinierten Profilanbieters.
Sie müssen Profilinformationen in einer Datenquelle speichern, die von den Profilanbietern, die im .NET Framework enthalten sind, nicht unterstützt wird, z. B. eine FoxPro-Datenbank, eine Oracle-Datenbank oder andere Datenspeicher.
Sie müssen Profilinformationen 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 Benutzerdaten, die bereits in einer SQL Server Datenbank für ein Unternehmensnetzwerk oder eine Website vorhanden sind.
Die ProfileProvider abstrakte Klasse erbt von der SettingsProvider abstrakten Klasse, die von der ProviderBase abstrakten Klasse erbt. Klassen, die implementiert ProfileProvider werden, müssen auch die erforderlichen Member der SettingsProvider und ProviderBase abstrakten Klassen implementieren. Weitere Informationen zum Implementieren eines Profilanbieters finden Sie unter Implementieren eines Profilanbieters.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ProfileProvider() |
Initialisiert eine neue Instanz der ProfileProvider-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ApplicationName |
Dient zum Abrufen oder Festlegen des Namens der derzeit ausgeführten Anwendung. (Geerbt von SettingsProvider) |
| 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 |
|---|---|
| DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime) |
Beim Überschreiben in einer abgeleiteten Klasse werden alle Benutzerprofildaten für Profile gelöscht, in denen das letzte Aktivitätsdatum vor dem angegebenen Datum aufgetreten ist. |
| DeleteProfiles(ProfileInfoCollection) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Profileigenschaften und Informationen für die angegebene Liste von Profilen gelöscht. |
| DeleteProfiles(String[]) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Profileigenschaften und Informationen für Profile gelöscht, die der angegebenen Liste der Benutzernamen entsprechen. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Profilinformationen für Profile abgerufen, in denen das letzte Aktivitätsdatum am oder vor dem angegebenen Datum aufgetreten ist und der Benutzername mit dem angegebenen Benutzernamen übereinstimmt. |
| FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Profilinformationen für Profile abgerufen, in denen der Benutzername den angegebenen Benutzernamen entspricht. |
| GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Benutzerprofildaten aus der Datenquelle für Profile abgerufen, in denen das datum der letzten Aktivität am oder vor dem angegebenen Datum aufgetreten ist. |
| GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Benutzerprofildaten für alle Profile in der Datenquelle abgerufen. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime) |
Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Profile zurückgegeben, in denen das letzte Aktivitätsdatum am oder vor dem angegebenen Datum aufgetreten ist. |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Gibt die Auflistung der Einstellungseigenschaftenwerte für die angegebene Anwendungsinstanz und die Einstellungseigenschaftsgruppe zurück. (Geerbt von SettingsProvider) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize(String, NameValueCollection) |
Initialisiert den Konfigurations-Generator. (Geerbt von ProviderBase) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Legt die Werte der angegebenen Gruppe von Eigenschafteneinstellungen fest. (Geerbt von SettingsProvider) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |