SqlMembershipProvider Classe

Référence

Définition

Espace de noms:: System.Web.Security

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

ProviderBase

MembershipProvider
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

Présentation de l’appartenance ASP.NET

Partager via