SqlProfileProvider Classe

Définition

Espace de noms:

System.Web.Profile

Assembly:

System.Web.dll

Gère le stockage des informations de profil pour une application ASP.NET dans une base de données SQL Server.

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

Héritage

Object

ProviderBase

SettingsProvider

ProfileProvider

SqlProfileProvider

Exemples

L’exemple de code suivant montre le fichier Web.config d’une application ASP.NET configurée pour utiliser un SqlProfileProviderfichier .

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

Remarques

Le profil ASP.NET est utilisé pour stocker et récupérer les paramètres utilisateur dans une source de données telle qu’une base de données. Le profil utilisateur est accessible à l’aide de la Profile propriété actuelle HttpContext. Les informations de profil et les valeurs de propriété sont gérées à l’aide d’un fournisseur de profils.

La SqlProfileProvider classe est utilisée par ASP.NET pour stocker et récupérer les paramètres de profil d’une application ASP.NET qui utilise une base de données SQL Server. Pour utiliser un SqlProfileProvider, vous devez d’abord créer la base de données SQL Server utilisée par le SqlProfileProvider. Pour créer la base de données utilisée par l’outil SqlProfileProvideraspnet_regsql.exe, qui se trouve dans le dossier [drive :]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber , puis spécifiez l’option -A p . La commande suivante montre comment utiliser l’exécutable aspnet_regsql.exe :

aspnet_regsql.exe -A p

L’exemple ci-dessus ne spécifie pas de nom pour la base de données créée. Par conséquent, le nom par défaut sera utilisé. Le nom de la base de données par défaut est Aspnetdb.

La configuration de l’ordinateur contient une instance par défaut SqlProfileProvider nommée AspNetSqlProvider qui se connecte au serveur SQL Server sur l’ordinateur local. Vous pouvez utiliser cette instance du fournisseur ou spécifier votre propre fichier dans le fichier Web.config de votre application ASP.NET.

Note

Si le fournisseur de profils est configuré avec une chaîne de connexion qui utilise la sécurité intégrée, le compte de processus de l’application ASP.NET doit disposer de droits pour se connecter à la base de données SQL Server.

Constructeurs

Nom	Description
SqlProfileProvider()	Crée une instance de la classe SqlProfileProvider.

Propriétés

Nom	Description
ApplicationName	Obtient ou définit le nom de l’application pour laquelle stocker et récupérer des informations de profil.
Description	Obtient une brève description conviviale adaptée à l’affichage dans les outils d’administration ou d’autres interfaces utilisateur (UIs). (Hérité de ProviderBase)
Name	Obtient le nom convivial utilisé pour faire référence au fournisseur pendant la configuration. (Hérité de ProviderBase)

Méthodes

Nom	Description
DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)	Supprime les données de profil utilisateur pour les profils dans lesquels la dernière date d’activité s’est produite avant la date et l’heure spécifiées.
DeleteProfiles(ProfileInfoCollection)	Supprime les propriétés et informations du profil pour la liste fournie des profils de la source de données.
DeleteProfiles(String[])	Supprime les propriétés de profil et les informations de la source de données pour la liste fournie des noms d’utilisateur.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)	Récupère les informations de profil pour les profils dans lesquels la date de la dernière activité s’est produite ou avant la date et l’heure spécifiées et le nom d’utilisateur du profil correspond au nom spécifié.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)	Récupère les informations de profil pour les profils dans lesquels le nom d’utilisateur correspond au nom spécifié.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)	Récupère les données de profil utilisateur pour les profils dans lesquels la dernière date d’activité s’est produite ou avant la date et l’heure spécifiées.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)	Récupère les données de profil utilisateur pour les profils dans la source de données.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)	Obtient le nombre de profils dans la source de données où la dernière date d’activité s’est produite ou avant la date spécifiée userInactiveSinceDate.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Récupère les informations et les valeurs des propriétés de profil à partir d’une base de données de profil SQL Server.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Initialize(String, NameValueCollection)	Initialise le fournisseur de profils SQL Server avec les valeurs de propriété spécifiées dans le fichier de configuration de l’application ASP.NET. Cette méthode n’est pas destinée à être utilisée directement à partir de votre code.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Met à jour la base de données de profil SQL Server avec les valeurs de propriété spécifiées.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Vue d’ensemble des propriétés de profil ASP.NET