FormsAuthenticationUser Classe

Référence

Définition

Espace de noms:: System.Web.Configuration

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.

Configure les informations d'identification de l'utilisateur pour les applications Web qui utilisent l'authentification à base de formulaires.

public ref class FormsAuthenticationUser sealed : System::Configuration::ConfigurationElement

public sealed class FormsAuthenticationUser : System.Configuration.ConfigurationElement

type FormsAuthenticationUser = class
    inherit ConfigurationElement

Public NotInheritable Class FormsAuthenticationUser
Inherits ConfigurationElement

Héritage: Object

ConfigurationElement
FormsAuthenticationUser

Exemples

L’exemple de code suivant montre comment obtenir l’accès FormsAuthenticationUserCollection aux FormsAuthenticationUser objets d’une application web existante. Le fichier de configuration contient une configuration similaire à ce qui suit.

Notes

Si vous utilisez l’élément d’informations d’identification pour les formulaires pour l’authentification (schéma ASP.NET Paramètres), veillez à suivre les instructions expliquées à ASP.NET Authentication. Pour une scalabilité et une meilleure sécurité, il est recommandé d’utiliser une base de données externe pour stocker les informations d’identification des utilisateurs. Pour plus d’informations sur la création d’applications ASP.NET sécurisées, consultez Sécurisation de votre application ASP.NET et création d’applications sécurisées ASP.NET : authentification, autorisation et communication sécurisée.

Cet exemple utilise SHA1. En raison de problèmes de collision avec SHA-1, Microsoft recommande SHA-256.

<authentication mode="Forms">
  <forms name="MyAppCookieName" loginUrl="/login.aspx">
    defaultUrl="formsdefault.aspx"
    protection="Encryption" timeout="5" path="aspnet"
    slidingExpiration="false"
    cookieless="UseCookies" domain="domainName">
    <credentials passwordFormat="SHA1">
      <user name="aspnetuser1"
        password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
       <user name="aspnetuser2"
         password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
    </credentials>
  </forms>
</authentication>


// Get the Web application configuration.
System.Configuration.Configuration configuration = 
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnet");
// Get the section.
AuthenticationSection authenticationSection = 
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");
// Get the users collection.
FormsAuthenticationUserCollection formsAuthenticationUsers =
    authenticationSection.Forms.Credentials.Users;

' Get the Web application configuration.
  Dim configuration _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnet")
' Get the section.
  Dim authenticationSection _
  As AuthenticationSection = _
  CType(configuration.GetSection( _
  "system.web/authentication"), AuthenticationSection)
' Get the users collection.
  Dim formsAuthenticationUsers _
  As FormsAuthenticationUserCollection = _
  authenticationSection.Forms.Credentials.Users

Remarques

La FormsAuthenticationUser classe permet d’accéder par programme et de modifier l’élément d’informations d’identification pour les formulaires pour la section d’authentification d’un fichier de configuration.

Ce type fait partie d’un groupe qui inclut les FormsAuthenticationCredentialstypes , les FormsAuthenticationUserCollectiontypes et les FormsAuthenticationConfiguration types. Les types autres que le type de collection affectent directement les balises de configuration sous-jacentes.

Notes

Les FormsAuthenticationUser informations peuvent écrire des informations dans la section associée du fichier de configuration au niveau de l’ordinateur, du site ou de l’application uniquement. Toute tentative d’écriture dans un fichier de configuration à un niveau différent dans la hiérarchie entraîne un message d’erreur généré par l’analyseur. Toutefois, vous pouvez utiliser cette classe pour lire les informations de configuration à n’importe quel niveau de la hiérarchie. Pour la sécurité et la scalabilité, il est recommandé d’utiliser un référentiel externe, tel qu’une base de données, pour conserver les informations d’identification des utilisateurs.

Constructeurs

FormsAuthenticationUser(String, String)

Initialise une nouvelle instance de la classe FormsAuthenticationUser avec les paramètres passés.

Propriétés

CurrentConfiguration	Obtient une référence à l'instance Configuration de niveau supérieur qui représente la hiérarchie de configuration à laquelle l'instance ConfigurationElement actuelle appartient. (Hérité de ConfigurationElement)
ElementInformation	Obtient un objet ElementInformation qui contient les fonctionnalités et informations non personnalisables de l'objet ConfigurationElement. (Hérité de ConfigurationElement)
ElementProperty	Obtient l'objet ConfigurationElementProperty qui représente l'objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EvaluationContext	Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
HasContext	Obtient une valeur qui indique si la propriété CurrentConfiguration a la valeur `null`. (Hérité de ConfigurationElement)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[String]	Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement)
LockAllAttributesExcept	Obtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l'élément est verrouillé. (Hérité de ConfigurationElement)
Name	Obtient ou définit le nom d'utilisateur de connexion.
Password	Obtient ou définit le mot de passe d'utilisateur.
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)

Méthodes

DeserializeElement(XmlReader, Boolean)	Lit du XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
Equals(Object)	Compare l’instance de ConfigurationElement actuelle à l’objet spécifié. (Hérité de ConfigurationElement)
GetHashCode()	Obtient une valeur unique représentant l'instance actuelle de ConfigurationElement. (Hérité de ConfigurationElement)
GetTransformedAssemblyString(String)	Retourne la version transformée du nom de l'assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Init()	Rétablit l’état initial de l’objet ConfigurationElement. (Hérité de ConfigurationElement)
InitializeDefault()	Utilisé pour initialiser un jeu de valeurs par défaut pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
IsModified()	Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargement lorsqu'il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement)
IsReadOnly()	Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement)
ListErrors(IList)	Ajoute les erreurs de propriété non valide dans cet objet ConfigurationElement et dans tous les sous-éléments à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré pendant la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtient une valeur indiquant si un élément inconnu est rencontré pendant la désérialisation. (Hérité de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu'une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Reset(ConfigurationElement)	Rétablit l'état interne de l'objet ConfigurationElement, y compris les verrouillages et les collections de propriétés. (Hérité de ConfigurationElement)
ResetModified()	Réinitialise la valeur de la méthode IsModified() à `false` en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Écrit le contenu de cet élément de configuration dans le fichier de configuration lorsqu'il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises extérieures de cet élément de configuration dans le fichier de configuration lorsqu'il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Affecte la valeur spécifiée à une propriété. (Hérité de ConfigurationElement)
SetReadOnly()	Définit la propriété IsReadOnly() pour l'objet ConfigurationElement et tous les sous-éléments. (Hérité de ConfigurationElement)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifie l'objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement)

S’applique à