SqlProfileProvider Klasse

Referenz

Definition

Namespace:: System.Web.Profile

Assembly:: System.Web.dll

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.

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 von SqlProfileProviderkonfiguriert ist.

<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 über die 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 ein SqlProfileProviderzu verwenden, müssen Sie zuerst die SQL Server-Datenbank erstellen, die SqlProfileProvidervon verwendet wird. Um die von SqlProfileProviderverwendete Datenbank zu erstellen, führen Sie das tool aspnet_regsql.exe aus, das sich im Ordner [Laufwerk:]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber befindet, 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, daher wird der Standardname verwendet. Der Standarddatenbankname ist Aspnetdb.

Die Computerkonfiguration enthält eine Standardinstanz SqlProfileProvider namens AspNetSqlProvider, die eine Verbindung mit sql Server auf dem lokalen Computer herstellt. Sie können diese Instanz des Anbieters verwenden oder eine 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 Berechtigungen 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)

Gilt für:

Weitere Informationen

Übersicht über ASP.NET Profileigenschaften

Freigeben über