FormsAuthenticationConfiguration 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 une application ASP.NET pour utiliser la modalité AuthenticationMode de formulaires.

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

public sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElement

type FormsAuthenticationConfiguration = class
    inherit ConfigurationElement

Public NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement

Héritage: Object

ConfigurationElement
FormsAuthenticationConfiguration

Exemples

L’exemple de code suivant montre comment obtenir l’objet FormsAuthenticationConfiguration à partir du fichier de configuration d’une application web existante. Vous pouvez utiliser cet objet pour accéder à ses membres. Le fichier de configuration contient un programme d’installation similaire à ce qui suit.

Note Si vous utilisez la credentials section, veillez à suivre les instructions expliquées dans ASP.NET Authentification. 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 ASP.NET sécurisées : 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="MyAppCookie" loginUrl="login.aspx"
    defaultUrl="default.aspx"
    protection="Encryption" timeout="5" path="aspnetTest"
    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("/aspnetTest");

// Get the external Authentication section.
AuthenticationSection authenticationSection = 
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");

// Get the external Forms section .
FormsAuthenticationConfiguration formsAuthentication =
    authenticationSection.Forms;

' Get the Web application configuration.
  Dim configuration As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

' Get the external Authentication section.
  Dim authenticationSection _
  As AuthenticationSection = _
  CType(configuration.GetSection( _
  "system.web/authentication"), AuthenticationSection)

' Get the external Forms section .
  Dim formsAuthentication _
  As FormsAuthenticationConfiguration = _
  authenticationSection.Forms

Remarques

La FormsAuthenticationConfiguration classe permet d’accéder par programmation à l’élément d’une section de configuration authentication et de les forms modifier.

Ce type fait partie d’un groupe qui comprend les FormsAuthenticationCredentialstypes , les FormsAuthenticationUserCollectionet .FormsAuthenticationUser Les types autres que le type de collection affectent directement les balises de configuration sous-jacentes.

Notes

peut FormsAuthenticationConfiguration écrire des informations dans la section associée du fichier de configuration en fonction des restrictions définies par la propriété AllowDefinition section dont la valeur est MachineToApplication. Toute tentative d’écriture dans un fichier de configuration à un niveau non autorisé 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 plus de sécurité et de scalabilité, il est recommandé d’utiliser un dépôt externe, tel qu’une base de données, pour conserver les informations d’identification des utilisateurs.

Constructeurs

FormsAuthenticationConfiguration()

Initialise une nouvelle instance de la classe FormsAuthenticationConfiguration.

Propriétés

Cookieless	Obtient ou définit une valeur qui indique si l'authentification à base de formulaires doit utiliser des cookies.
CookieSameSite	Obtient ou définit la valeur de l’attribut SameSite du cookie.
Credentials	Obtient la collection FormsAuthenticationCredentials de noms d'utilisateurs et de mots de passe.
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)
DefaultUrl	Obtient ou définit l'URL par défaut.
Domain	Obtient ou définit le nom de domaine à envoyer avec les cookies d'authentification par formulaire.
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)
EnableCrossAppRedirects	Obtient ou définit une valeur indiquant si les utilisateurs authentifiés peuvent être redirigés vers des URL dans d'autres applications.
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)
LoginUrl	Obtient ou définit l'URL de redirection pour la demande.
Name	Obtient ou définit le nom du cookie.
Path	Obtient ou définit le chemin d'accès du cookie.
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)
Protection	Obtient ou définit le type de chiffrement utilisé pour chiffrer le cookie.
RequireSSL	Obtient ou définit une valeur qui indique si une connexion SSL (Secure Sockets Layer) est requise lors de la transmission d'informations d'identification.
SlidingExpiration	Obtient ou définit l'expiration décalée d'authentification.
TicketCompatibilityMode	Obtient ou définit une valeur qui indique s'il convient d'utiliser le temps universel coordonné ou l'heure locale pour la date d'expiration du ticket.
Timeout	Obtient ou définit le délai d'expiration de l'authentification.

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 à

Partager via