SessionStateSection 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 el estado de sesión para una aplicación Web.
public ref class SessionStateSection sealed : System::Configuration::ConfigurationSectionpublic sealed class SessionStateSection : System.Configuration.ConfigurationSectiontype SessionStateSection = class
inherit ConfigurationSectionPublic NotInheritable Class SessionStateSection
Inherits ConfigurationSection- Herencia
Ejemplos
En esta sección se proporcionan dos ejemplos de código. En la primera se muestra cómo especificar los valores mediante declaración para varios atributos de la sección, a los sessionState que también se puede acceder como miembros de la SessionStateSection clase . En el segundo se muestra cómo usar la SessionStateSection clase .
En el siguiente ejemplo de archivo de configuración se muestra cómo especificar los valores mediante declaración para la sessionState sección .
<configuration>
<system.web>
<sessionState mode="InProc"
stateConnectionString="tcpip=127.0.0.1:42424"
stateNetworkTimeout="10"
sqlConnectionString="data source=127.0.0.1;
Integrated Security=SSPI"
sqlCommandTimeout="30"
customProvider=""
cookieless="UseDeviceProfile"
cookieName="ASP.NET_SessionId"
timeout="20"
allowCustomSqlDatabase="False"
regenerateExpiredSessionId="False"
partitionResolverType=""
useHostingIdentity="True">
<providers>
<clear />
</providers>
</sessionState>
</system.web>
</configuration>
En el ejemplo de código siguiente se muestra cómo usar la SessionStateSection clase .
// Get the Web application configuration object.
System.Configuration.Configuration configuration =
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the section related object.
System.Web.Configuration.SessionStateSection sessionStateSection =
(System.Web.Configuration.SessionStateSection)
configuration.GetSection("system.web/sessionState");
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest")
' Get the section.
Dim sessionStateSection As System.Web.Configuration.SessionStateSection = _
CType(configuration.GetSection("system.web/sessionState"), _
System.Web.Configuration.SessionStateSection)
Comentarios
La SessionStateSection clase hace referencia al elemento del archivo de configuración Machine.config o Web.config identificado por la sessionState etiqueta .
Cuando un nuevo cliente comienza a interactuar con una aplicación web, se emite un identificador de sesión y se asocia con todas las solicitudes posteriores del mismo cliente durante el tiempo en que la sesión es válida. Este identificador se usa para mantener el estado del lado servidor asociado a la sesión de cliente entre solicitudes. Controla SessionStateSection cómo la aplicación ASP.NET establece y mantiene esta asociación en nombre de cada cliente.
Este mecanismo es muy flexible y le ofrece la posibilidad de hospedar información de estado de sesión fuera del proceso y realizar un seguimiento del estado sin usar cookies, entre otras cosas.
Constructores
| SessionStateSection() |
Inicializa una nueva instancia de la clase SessionStateSection. |
Propiedades
| AllowCustomSqlDatabase |
Obtiene o establece un valor que indica si el usuario puede especificar el valor de catálogo inicial en la propiedad SqlConnectionString. |
| CompressionEnabled |
Obtiene o establece un valor que indica si la compresión está habilitada para los datos de estado de sesión. |
| Cookieless |
Obtiene o establece un valor que indica si se van a utilizar cookies para identificar las sesiones de cliente. |
| CookieName |
Obtiene o establece el nombre de cookie. |
| CookieSameSite |
Obtiene o establece el valor del atributo SameSite de la cookie. |
| 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 actual de ConfigurationElement. (Heredado de ConfigurationElement) |
| CustomProvider |
Obtiene o establece el nombre del proveedor personalizado de la colección Providers. |
| ElementInformation |
Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| ElementProperty |
Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| EvaluationContext |
Obtiene el objeto ContextInformation para el 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) |
| Mode |
Obtiene o establece un valor que especifica dónde se almacenará el estado de sesión. |
| PartitionResolverType |
Obtiene o establece un valor que especifica dónde se almacenará el estado de sesión. |
| Properties |
Obtiene la colección de propiedades. (Heredado de ConfigurationElement) |
| Providers |
Obtiene los proveedores de ProviderSettingsCollection actuales. |
| RegenerateExpiredSessionId |
Obtiene o establece un valor que indica si se volverá a emitir el id. de sesión cuando el cliente especifique un id. de sesión expirado. |
| SectionInformation |
Obtiene un objeto SectionInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationSection. (Heredado de ConfigurationSection) |
| SessionIDManagerType |
Obtiene o establece un valor que especifica el tipo completo del administrador de id. de sesión. |
| SqlCommandTimeout |
Obtiene o establece el tiempo de espera de los comandos SQL en el modo de estado de sesión de SQL Server. |
| SqlConnectionRetryInterval |
Obtiene o establece el intervalo de tiempo que debe transcurrir antes de que ASP.NET vuelva a conectarse a la base de datos. |
| SqlConnectionString |
Obtiene o establece la cadena de conexión SQL. |
| StateConnectionString |
Obtiene o establece la cadena de conexión del servidor de estado. |
| StateNetworkTimeout |
Obtiene o establece el tiempo durante el cual puede permanecer inactiva la conexión de red entre el servidor Web y el servidor de estado. |
| Timeout |
Obtiene o establece el tiempo de espera de la sesión. |
| UseHostingIdentity |
Obtiene o establece un valor que especifica si el estado de sesión utilizará la suplantación del cliente cuando esté disponible o si siempre volverá a la identidad que la hospeda. |
Métodos
| DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
| DeserializeSection(XmlReader) |
Lee XML del archivo de configuración. (Heredado de ConfigurationSection) |
| Equals(Object) |
Compara la instancia actual de ConfigurationElement con el objeto especificado. (Heredado de ConfigurationElement) |
| GetHashCode() |
Obtiene un valor único que representa la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement) |
| GetRuntimeObject() |
Devuelve un objeto personalizado cuando se reemplaza en una clase derivada. (Heredado de ConfigurationSection) |
| 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 utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
| IsModified() |
Indica si se ha modificado este elemento de configuración desde la última vez en que se guardo o cargó al implementarlo en una clase derivada. (Heredado de ConfigurationSection) |
| IsReadOnly() |
Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura. (Heredado de ConfigurationElement) |
| ListErrors(IList) |
Agrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos. (Heredado de ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Se inicia una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
| PostDeserialize() |
Se llama a este método después de la deserialización. (Heredado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Se llama a este método antes de la serialización. (Heredado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Restablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement) |
| ResetModified() |
Restablece el valor del método IsModified() en |
| 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) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Crea una cadena XML que contiene una vista separada del objeto ConfigurationSection como una sección única para escribir en un archivo. (Heredado de ConfigurationSection) |
| 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) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica si el elemento especificado se debe serializar cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Heredado de ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica si la propiedad especificada se debe serializar cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Heredado de ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica si la instancia actual ConfigurationSection se debe serializar cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Heredado de ConfigurationSection) |
| 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) |
