SqlProfileProvider Klasse

Definition

Namespace:

System.Web.Profile

Assembly:

System.Web.dll

Verwaltet die Speicherung von 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 sql Server-Datenbank erstellen, die von der SqlProfileProvider. Um die vom SqlProfileProviderTool verwendete Datenbank zu erstellen, führen Sie das aspnet_regsql.exe Tool aus, das sich im Ordner [drive:]\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, 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

Name	Beschreibung
SqlProfileProvider()	Erstellt eine Instanz der SqlProfileProvider-Klasse.

Eigenschaften

Name	Beschreibung
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 (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)	Löscht Benutzerprofildaten für Profile, in denen das letzte Aktivitätsdatum vor dem angegebenen Datum und der angegebenen Uhrzeit aufgetreten ist.
DeleteProfiles(ProfileInfoCollection)	Löscht Profileigenschaften und Informationen für die angegebene Liste von Profilen aus der Datenquelle.
DeleteProfiles(String[])	Löscht Profileigenschaften und Informationen aus der Datenquelle für die angegebene Liste der Benutzernamen.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)	Ruft Profilinformationen für Profile ab, in denen das letzte Aktivitätsdatum am oder vor dem angegebenen Datum und der angegebenen Uhrzeit aufgetreten ist und der Benutzername für das Profil mit dem angegebenen Namen übereinstimmt.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)	Ruft Profilinformationen für Profile ab, in denen der Benutzername mit dem angegebenen Namen übereinstimmt.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)	Ruft Benutzerprofildaten für Profile ab, in denen das datum der letzten Aktivität am oder vor dem angegebenen Datum und der angegebenen Uhrzeit aufgetreten ist.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)	Ruft Benutzerprofildaten für Profile in der Datenquelle ab.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)	Ruft die Anzahl der Profile in der Datenquelle ab, an denen das letzte Aktivitätsdatum aufgetreten ist oder vor dem angegebenen .userInactiveSinceDate
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Ruft Profileigenschafteninformationen und -werte aus einer SQL Server-Profildatenbank ab.
GetType()	Ruft die 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 soll nicht direkt aus Dem Code verwendet werden.
MemberwiseClone()	Erstellt eine flache Kopie der 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)

Weitere Informationen

• Übersicht über ASP.NET Profileigenschaften