FormsAuthenticationConfiguration Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Configura una aplicación de ASP.NET para usar la modalidad de formularios AuthenticationMode.
public ref class FormsAuthenticationConfiguration sealed : System::Configuration::ConfigurationElementpublic sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElementtype FormsAuthenticationConfiguration = class
inherit ConfigurationElementPublic NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement- Herencia
Ejemplos
En el ejemplo de código siguiente se muestra cómo obtener el objeto FormsAuthenticationConfiguration del archivo de configuración de una aplicación web existente. Puede usar este objeto para acceder a sus miembros.
// 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
Comentarios
La clase FormsAuthenticationConfiguration proporciona una manera de obtener acceso mediante programación y modificar el elemento forms de una sección de authentication de configuración.
Este tipo forma parte de un grupo que incluye el FormsAuthenticationCredentials, el FormsAuthenticationUserCollectiony los tipos de FormsAuthenticationUser. Los tipos distintos del tipo de colección afectan directamente a las etiquetas de configuración subyacentes.
Advertencia
El almacenamiento de credenciales de usuario en la sección credentials es inseguro. En su lugar, use Azure Key Vault.
Nota
El FormsAuthenticationConfiguration puede escribir información en la sección relacionada del archivo de configuración según las restricciones definidas por la propiedad section AllowDefinition cuyo valor es MachineToApplication. Cualquier intento de escribir en un archivo de configuración en un nivel no permitido en la jerarquía producirá un mensaje de error generado por el analizador. Sin embargo, puede usar esta clase para leer información de configuración en cualquier nivel de la jerarquía. Para mayor seguridad y escalabilidad, se recomienda usar Azure Key Vault para almacenar las credenciales de usuario.
Constructores
| FormsAuthenticationConfiguration() |
Inicializa una nueva instancia de la clase FormsAuthenticationConfiguration. |
Propiedades
| Cookieless |
Obtiene o establece un valor que indica si la autenticación basada en formularios debe usar cookies. |
| CookieSameSite |
Obtiene o establece el valor del atributo SameSite de la cookie. |
| Credentials |
Obtiene la colección FormsAuthenticationCredentials de nombres de usuario y contraseñas. |
| CurrentConfiguration |
Obtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia de ConfigurationElement actual. (Heredado de ConfigurationElement) |
| DefaultUrl |
Obtiene o establece la dirección URL predeterminada. |
| Domain |
Obtiene o establece el nombre de dominio que se va a enviar con cookies de autenticación de formularios. |
| ElementInformation |
Obtiene un objeto ElementInformation que contiene la información y la funcionalidad no personalizables del objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| ElementProperty |
Obtiene el objeto ConfigurationElementProperty que representa el propio objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| EnableCrossAppRedirects |
Obtiene o establece un valor que indica si los usuarios autenticados se pueden redirigir a direcciones URL en otras aplicaciones. |
| EvaluationContext |
Obtiene el objeto ContextInformation del objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| HasContext |
Obtiene un valor que indica si la propiedad CurrentConfiguration es |
| Item[ConfigurationProperty] |
Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement) |
| Item[String] |
Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración. (Heredado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockAllElementsExcept |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockAttributes |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
| LockElements |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
| LockItem |
Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement) |
| LoginUrl |
Obtiene o establece la dirección URL de redireccionamiento de la solicitud. |
| Name |
Obtiene o establece el nombre de la cookie. |
| Path |
Obtiene o establece la ruta de acceso de la cookie. |
| Properties |
Obtiene la colección de propiedades. (Heredado de ConfigurationElement) |
| Protection |
Obtiene o establece el tipo de cifrado utilizado para cifrar la cookie. |
| RequireSSL |
Obtiene o establece un valor que indica si se requiere una conexión de Capa de sockets seguros (SSL) al transmitir información de autenticación. |
| SlidingExpiration |
Obtiene o establece la expiración deslizante de autenticación. |
| TicketCompatibilityMode |
Obtiene o establece un valor que indica si se debe usar la hora universal coordinada (UTC) o la hora local para la fecha de expiración del vale. |
| Timeout |
Obtiene o establece el tiempo de espera de autenticación. |
Métodos
| DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
| Equals(Object) |
Compara la instancia de ConfigurationElement actual con el objeto especificado. (Heredado de ConfigurationElement) |
| GetHashCode() |
Obtiene un valor único que representa la instancia de ConfigurationElement actual. (Heredado de ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Init() |
Establece el objeto ConfigurationElement en su estado inicial. (Heredado de ConfigurationElement) |
| InitializeDefault() |
Se usa para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| IsModified() |
Indica si este elemento de configuración se ha modificado desde que se guardó o cargó por última vez, cuando se implementó en una clase derivada. (Heredado de ConfigurationElement) |
| IsReadOnly() |
Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura. (Heredado de ConfigurationElement) |
| ListErrors(IList) |
Agrega los errores de propiedad no válida en este objeto ConfigurationElement y, en todos los subelementos, a la lista pasada. (Heredado de ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se encuentra un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtiene un valor que indica si se encuentra un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Produce una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
| PostDeserialize() |
Se llama después de la deserialización. (Heredado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Se llama antes de la serialización. (Heredado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Restablece el estado interno del objeto ConfigurationElement, incluidos los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement) |
| ResetModified() |
Restablece el valor del método IsModified() a |
| SerializeElement(XmlWriter, Boolean) |
Escribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement) |
| SetReadOnly() |
Establece la propiedad IsReadOnly() para el objeto ConfigurationElement y todos los subelementos. (Heredado de ConfigurationElement) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement) |
