SessionStateSection Clase

Definición

Espacio de nombres:
System.Web.Configuration
Ensamblado:
System.Web.dll

Configura el estado de sesión de una aplicación web.

public ref class SessionStateSection sealed : System::Configuration::ConfigurationSection
public sealed class SessionStateSection : System.Configuration.ConfigurationSection
type SessionStateSection = class
    inherit ConfigurationSection
Public NotInheritable Class SessionStateSection
Inherits ConfigurationSection
Herencia
Object
ConfigurationElement
ConfigurationSection
SessionStateSection

Ejemplos

En esta sección se proporcionan dos ejemplos de código. En la primera se muestra cómo especificar valores declarativamente para varios atributos de la sessionState sección, a los que también se puede tener acceso 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 valores declarativamente 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 Machine.config o Web.config archivo de configuración 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 a 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. El SessionStateSection controla cómo establece y mantiene la aplicación ASP.NET esta asociación en nombre de cada cliente.

Este mecanismo es muy flexible y le ofrece la capacidad 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

Nombre Description
SessionStateSection()

Inicializa una nueva instancia de la clase SessionStateSection.

Propiedades

Nombre Description
AllowCustomSqlDatabase

Obtiene o establece un valor que indica si el usuario puede especificar el valor de catálogo inicial en la SqlConnectionString propiedad .
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 las cookies se usan para identificar las sesiones de cliente.
CookieName

Obtiene o establece el nombre de la cookie.
CookieSameSite

Obtiene o establece el valor del atributo SameSite de la cookie.
CurrentConfiguration

Obtiene una referencia a la instancia de nivel Configuration superior que representa la jerarquía de configuración a la que pertenece la instancia actual ConfigurationElement .

(Heredado de ConfigurationElement)
CustomProvider

Obtiene o establece el nombre del proveedor personalizado de la Providers colección.
ElementInformation

Obtiene un ElementInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationElement objeto .

(Heredado de ConfigurationElement)
ElementProperty

Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto.

(Heredado de ConfigurationElement)
EvaluationContext

Obtiene el objeto ContextInformation para el objeto ConfigurationElement.

(Heredado de ConfigurationElement)
HasContext

Obtiene un valor que indica si la CurrentConfiguration propiedad es null.

(Heredado de ConfigurationElement)
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 almacenar el estado de sesión.
PartitionResolverType

Obtiene o establece un valor que especifica dónde almacenar el estado de sesión.
Properties

Obtiene la colección de propiedades.

(Heredado de ConfigurationElement)
Providers

Obtiene los proveedores actuales ProviderSettingsCollection .
RegenerateExpiredSessionId

Obtiene o establece un valor que indica si se volverá a emitir el identificador de sesión cuando el cliente especifique un identificador de sesión expirado.
SectionInformation

Obtiene un SectionInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationSection objeto .

(Heredado de ConfigurationSection)
SessionIDManagerType

Obtiene o establece un valor que especifica el tipo completo del Administrador de identificadores de sesión.
SqlCommandTimeout

Obtiene o establece el tiempo de espera de duración de los comandos SQL mediante 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 la cantidad de tiempo que la conexión de red entre el servidor web y el servidor de estado pueden permanecer inactivos.
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 usará la suplantación de cliente cuando esté disponible, o siempre revertirá a la identidad de hospedaje.

Métodos

Nombre Description
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 ConfigurationElement con el objeto especificado.

(Heredado de ConfigurationElement)
GetHashCode()

Obtiene un valor único que representa la instancia actual ConfigurationElement .

(Heredado de ConfigurationElement)
GetRuntimeObject()

Devuelve un objeto personalizado cuando se invalida 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 ConfigurationElement objeto en su estado inicial.

(Heredado de ConfigurationElement)
InitializeDefault()

Se usa para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto .

(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 ConfigurationSection)
IsReadOnly()

Obtiene un valor que indica si el ConfigurationElement objeto es de solo lectura.

(Heredado de ConfigurationElement)
ListErrors(IList)

Agrega los errores de propiedad no válida en este ConfigurationElement objeto 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 ConfigurationElement objeto, incluidos los bloqueos y las colecciones de propiedades.

(Heredado de ConfigurationElement)
ResetModified()

Restablece el valor del IsModified() método a false cuando se implementa en una clase derivada.

(Heredado de ConfigurationSection)
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 no combinada del ConfigurationSection objeto como una sola sección 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 IsReadOnly() propiedad para el ConfigurationElement objeto 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 se debe serializar la instancia de ConfigurationSection actual 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 ConfigurationElement objeto para quitar todos los valores que no se deben guardar.

(Heredado de ConfigurationElement)

Se aplica a

Consulte también