SqlMembershipProvider Classe

Définition

Gère le stockage des informations d'appartenance (membership) pour une application ASP.NET dans une base de données SQL Server.

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider
public class SqlMembershipProvider : System.Web.Security.MembershipProvider
type SqlMembershipProvider = class
    inherit MembershipProvider
Public Class SqlMembershipProvider
Inherits MembershipProvider
Héritage
SqlMembershipProvider

Exemples

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

<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>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Remarques

Notes

ASP.NET fournisseurs d’appartenances ont été remplacés par ASP.NET Identity. Nous vous recommandons vivement de mettre à jour les applications pour utiliser la plateforme d’identité ASP.NET plutôt que les fournisseurs d’appartenance.

Cette classe est utilisée par les classes et MembershipUser pour fournir des services d’appartenance pour une application ASP.NET à l’aide Membership d’une base de données SQL Server. Vous ne pouvez pas utiliser un SqlMembershipProvider sans SQL Server. Lorsque SQL Server Express est installé sur votre ordinateur avec le nom d’instance par défaut et l’instanciation de l’utilisateur activés, l’objet SqlMembershipProvider crée une base de données appelée aspnetdb dans le répertoire de App_Data l’application la première fois que l’application est exécutée.

Pour créer manuellement la base de données, exécutez l’exécutable Aspnet_regsql.exe trouvé dans le %systemroot%\Microsoft.NET\Framework\ versionNumber dossier et spécifiez l’option -A m (par exemple aspnet_regsql.exe -A m). La base de données créée est appelée Aspnetdb. Vous pouvez également exécuter pour extraire Aspnet_regsql.exe le mode de configuration de l’interface utilisateur graphique et choisir de configurer toutes les fonctionnalités ASP.NET.

Si le fournisseur d’appartenances 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 des droits pour se connecter à la base de données SQL Server.

Le fichier Machine.config définit une instance par défaut SqlMembershipProvider nommée AspNetSqlMembershipProvider qui se connecte à l’instance SQL Server Express par défaut sur l’ordinateur local. Vous pouvez utiliser cette instance du fournisseur si vous avez installé SQL Server Express avec le nom d’instance par défaut, ou vous pouvez définir votre propre instance dans le fichier Web.config pour votre application ASP.NET.

Si vous définissez l’attribut passwordCompatMode sur Framework40, l’application peut utiliser les options de hachage et d’appartenance au chiffrement qui ont été ajoutées dans ASP.NET 4. Toutefois, si l’attribut passwordCompatMode est défini sur Framework20, seules les options de hachage et d’appartenance au chiffrement des ASP.NET 2.0, ASP.NET 3.5 et ASP.NET 3.5 SP1 peuvent être utilisées. La valeur par défaut est Framework20. Pour plus d'informations, consultez MembershipPasswordCompatibilityMode.

Constructeurs

SqlMembershipProvider()

Initialise une nouvelle instance de la classe SqlMembershipProvider.

Propriétés

ApplicationName

Obtient ou définit le nom de l'application pour laquelle stocker ou récupérer des informations d'appartenance.

Description

Obtient une description brève et conviviale qui peut s'afficher dans les outils d'administration ou d'autres interfaces utilisateur.

(Hérité de ProviderBase)
EnablePasswordReset

Obtient une valeur indiquant si le fournisseur d'appartenances SQL Server est configuré pour permettre aux utilisateurs de réinitialiser leur mot de passe.

EnablePasswordRetrieval

Obtient une valeur indiquant si le fournisseur d'appartenances SQL Server est configuré pour permettre aux utilisateurs de récupérer leur mot de passe.

MaxInvalidPasswordAttempts

Obtient le nombre de tentatives autorisées de saisie de mot de passe ou de réponse de mot de passe non valide avant que l’utilisateur d’appartenance soit verrouillé.

MinRequiredNonAlphanumericCharacters

Obtient le nombre minimal de caractères spéciaux qui doivent être présents dans un mot de passe.

MinRequiredPasswordLength

Obtient la longueur minimale requise pour un mot de passe.

Name

Obtient le nom convivial qui référence le fournisseur au cours de la configuration.

(Hérité de ProviderBase)
PasswordAttemptWindow

Obtient la fenêtre de temps durant laquelle sont suivis les échecs des tentatives successives pour fournir un mot de passe ou des réponses de mot de passe valides.

PasswordFormat

Obtient une valeur indiquant le format de stockage des mots de passe dans la base de données d’appartenance SQL Server.

PasswordStrengthRegularExpression

Obtient l’expression régulière utilisée pour évaluer un mot de passe.

RequiresQuestionAndAnswer

Obtient une valeur indiquant si le fournisseur d'appartenances SQL Server est configuré pour demander à l'utilisateur de répondre à une question de mot de passe en vue de la réinitialisation et de la récupération de mot de passe.

RequiresUniqueEmail

Obtient une valeur qui indique si le fournisseur d’appartenances SQL Server est configuré afin d’exiger une adresse e-mail unique pour chaque nom d’utilisateur.

Méthodes

ChangePassword(String, String, String)

Modifie le mot de passe d'un utilisateur.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Met à jour la question et la réponse de mot de passe d'un utilisateur dans la base de données d'appartenances SQL Server.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Ajoute un nouvel utilisateur à la base de données d'appartenances SQL Server.

DecryptPassword(Byte[])

Déchiffre un mot de passe chiffré.

(Hérité de MembershipProvider)
DeleteUser(String, Boolean)

Supprime les informations d'appartenance d'un utilisateur dans la base de données d'appartenances SQL Server.

EncryptPassword(Byte[])

Chiffre un mot de passe.

(Hérité de MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Chiffre le mot de passe spécifié à l'aide du mode de compatibilité de mot de passe indiqué.

(Hérité de MembershipProvider)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FindUsersByEmail(String, Int32, Int32, Int32)

Retourne une collection d’utilisateurs d’appartenance dont l’adresse e-mail correspond à l’adresse spécifiée.

FindUsersByName(String, Int32, Int32, Int32)

Obtient une collection d'utilisateurs d'appartenance dont le nom d'utilisateur correspond au nom spécifié.

GeneratePassword()

Génère un mot de passe aléatoire qui comprend au moins 14 caractères.

GetAllUsers(Int32, Int32, Int32)

Obtient une collection de tous les utilisateurs dans la base de données d'appartenances SQL Server.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetNumberOfUsersOnline()

Retourne le nombre d'utilisateurs qui accèdent actuellement à l'application.

GetPassword(String, String)

Retourne le mot de passe pour le nom d'utilisateur spécifié de la base de données d'appartenances SQL Server.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUser(Object, Boolean)

Obtient de la source de données les informations sur l'utilisateur d'appartenance associé à l'identificateur unique spécifié et met à jour les informations de date et heure de dernière activité de l'utilisateur, le cas échéant.

GetUser(String, Boolean)

Retourne des informations de la base de données d'appartenance SQL Server pour un utilisateur et fournit une option permettant de mettre à jour les informations sur les date et heure de dernière activité de l'utilisateur.

GetUserNameByEmail(String)

Obtient le nom d’utilisateur associé à l’adresse e-mail spécifiée.

Initialize(String, NameValueCollection)

Initialise le fournisseur d'appartenances 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 depuis votre code.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Déclenche l’événement ValidatingPassword si un gestionnaire d’événements a été défini.

(Hérité de MembershipProvider)
ResetPassword(String, String)

Réinitialise le mot de passe d’un utilisateur et affecte un nouveau mot de passe généré automatiquement.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
UnlockUser(String)

Efface l'état verrouillé de l'utilisateur afin que l'utilisateur d'appartenance puisse être validé.

UpdateUser(MembershipUser)

Met à jour les informations à propos d'un utilisateur dans la base de données d'appartenances SQL Server.

ValidateUser(String, String)

Vérifie l'existence du mot de passe et du nom d'utilisateur spécifiés dans la base de données d'appartenances SQL Server.

Événements

ValidatingPassword

Se produit quand un utilisateur est créé ou quand un mot de passe est modifié ou réinitialisé.

(Hérité de MembershipProvider)

S’applique à

Voir aussi