SqlProfileProvider Klasse

Definition

Namespace:

System.Web.Profile

Assembly:

System.Web.dll

Verwaltet Speicher der Profilinformationen für eine ASP.NET-Anwendung in einer SQL Server-Datenbank.

public ref class SqlProfileProvider : System::Web::Profile::ProfileProvider

public class SqlProfileProvider : System.Web.Profile.ProfileProvider

type SqlProfileProvider = class
    inherit ProfileProvider

Public Class SqlProfileProvider
Inherits ProfileProvider

Vererbung

Object

ProviderBase

SettingsProvider

ProfileProvider

SqlProfileProvider

Beispiele

Das folgende Codebeispiel zeigt die Web.config Datei für eine ASP.NET Anwendung, die für die Verwendung einer .SqlProfileProvider

<configuration>  
  <connectionStrings>  
    <add name="SqlServices" connectionString=  
      "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />  
  </connectionStrings>  

  <system.web>  
    <authentication mode="Forms" >  
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />  
    </authentication>  
    <authorization>  
      <deny users="?" />  
    </authorization>  
    <membership defaultProvider="SqlProvider"   
      userIsOnlineTimeWindow="15">  
      <providers>  
        <clear/>  
        <add name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="SampleApplication"  
          enablePasswordRetrieval="true"  
          enablePasswordReset="true"  
          passwordFormat="Encrypted"  
          requiresQuestionAndAnswer="true" />  
      </providers>  
    </membership>  

    <profile defaultProvider="SqlProvider">  
      <providers>  
        <clear />  
        <add name="SqlProvider"  
          type="System.Web.Profile.SqlProfileProvider"  
          connectionStringName="SqlServices"  
          applicationName="SampleApplication"  
          description="SqlProfileProvider for SampleApplication" />  
      </providers>  

      <properties>  
        <add name="ZipCode" />  
        <add name="CityAndState" />  
      </properties>  
    </profile>  
  </system.web>  
</configuration>  

Hinweise

Das ASP.NET Profil wird verwendet, um Benutzereinstellungen in einer Datenquelle wie einer Datenbank zu speichern und abzurufen. Auf das Benutzerprofil wird mithilfe der Profile Eigenschaft des aktuellen HttpContextZugegriffen. Profilinformationen und Eigenschaftswerte werden mithilfe eines Profilanbieters verwaltet.

Die SqlProfileProvider Klasse wird von ASP.NET zum Speichern und Abrufen von Profileinstellungen für eine ASP.NET Anwendung verwendet, die eine SQL Server Datenbank verwendet. Um eine SqlProfileProviderZu verwenden, müssen Sie zuerst die von der SqlProfileProviderSQL Server verwendete Datenbank erstellen. Um die datenbank zu erstellen, die vom SqlProfileProviderTool verwendet wird, führen Sie das tool aspnet_regsql.exe aus, das im Ordner [drive:]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber gefunden wird, und geben Sie die Option "-A p " an. Der folgende Befehl veranschaulicht, wie Sie die ausführbare aspnet_regsql.exe verwenden können:

aspnet_regsql.exe -A p  

Im obigen Beispiel wird kein Name für die datenbank angegeben, die erstellt wird, sodass der Standardname verwendet wird. Der Standarddatenbankname ist Aspnetdb.

Die Computerkonfiguration enthält eine Standardinstanz SqlProfileProvider namens AspNetSqlProvider, die eine Verbindung mit dem SQL Server auf dem lokalen Computer herstellt. Sie können diese Instanz des Anbieters verwenden oder ihre eigene in der Web.config Datei für Ihre ASP.NET Anwendung angeben.

Hinweis

Wenn der Profilanbieter mit einer Verbindungszeichenfolge konfiguriert ist, die integrierte Sicherheit verwendet, muss das Prozesskonto der ASP.NET-Anwendung über Rechte zum Herstellen einer Verbindung mit der SQL Server Datenbank verfügen.

Konstruktoren

SqlProfileProvider()

Erstellt eine Instanz der SqlProfileProvider-Klasse.

Eigenschaften

ApplicationName	Ruft den Namen der Anwendung ab, für die Profilinformationen 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 geeignet ist. (Geerbt von ProviderBase)
Name	Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase)

Methoden

DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)	Löscht Benutzerprofildaten für Profile, bei denen das Datum der letzten Aktivität vor dem angegebenen Datum und der angegeben Uhrzeit liegt.
DeleteProfiles(ProfileInfoCollection)	Löscht Profileigenschaften und Informationen für die angegebene Liste mit Profilen aus der Datenquelle.
DeleteProfiles(String[])	Löscht Profileigenschaften und Informationen aus der Datenquelle für die angegebene Liste mit Benutzernamen.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)	Ruft Profilinformationen für Profile ab, bei denen das Datum der letzten Aktivität am oder vor dem angegebenen Datum und der angegebenen Uhrzeit liegt und bei denen der Benutzername des Profils dem angegebenen Namen entspricht.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)	Ruft Profilinformationen für Profile ab, bei denen der Benutzername mit dem angegebenen Namen übereinstimmt.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)	Ruft Benutzerprofildaten für Profile ab, bei denen das Datum der letzten Aktivität am oder vor dem angegebenen Datum und der angegeben Uhrzeit liegt.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)	Ruft Benutzerprofildaten für Profile in der Datenquelle ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)	Ruft die Anzahl der Profile in der Datenquelle ab, bei denen das Datum der letzten Aktivität am oder vor dem angegebenen userInactiveSinceDate liegt.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Ruft Profileigenschafteninformationen und Werte aus einer SQL Server-Profildatenbank ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize(String, NameValueCollection)	Initialisiert den SQL Server-Profilanbieter mit den Eigenschaftswerten, die in der Konfigurationsdatei der ASP.NET-Anwendung angegeben sind. Diese Methode ist nicht für die direkte Verwendung im Code vorgesehen.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Aktualisiert die SQL Server-Profildatenbank mit den angegebenen Eigenschaftswerten.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Siehe auch

• Übersicht über ASP.NET Profileigenschaften