SessionStateSection Clase

Definición

Configura el estado de sesión para una aplicación Web.Configures the session state for a Web application.

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

Ejemplos

En esta sección se proporcionan dos ejemplos de código.This section provides two code examples. En el primero se muestra cómo especificar valores de forma declarativa para varios atributos de la sección sessionState, a los que también se puede tener acceso como miembros de la clase SessionStateSection.The first demonstrates how to specify values declaratively for several attributes of the sessionState section, which can also be accessed as members of the SessionStateSection class. En el segundo se muestra cómo usar la clase SessionStateSection.The second demonstrates how to use the SessionStateSection class.

En el siguiente ejemplo de archivo de configuración se muestra cómo especificar valores de forma declarativa para la sección sessionState.The following configuration file example shows how to specify values declaratively for the sessionState section.

<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 clase SessionStateSection.The following code example demonstrates how to use the SessionStateSection class.

// 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 clase SessionStateSection hace referencia al elemento en el archivo de configuración Machine. config o Web. config identificado por la etiqueta sessionState.The SessionStateSection class refers to the element in the Machine.config or Web.config configuration file identified by the sessionState tag.

Cuando un cliente nuevo 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 en el momento en que la sesión es válida.When a new client begins interacting with a Web application, a session ID is issued and associated with all the subsequent requests from the same client during the time that the session is valid. Este identificador se usa para mantener el estado del lado servidor asociado a la sesión del cliente a través de las solicitudes.This ID is used to maintain server-side state associated with the client session across requests. El SessionStateSection controla el modo en que la aplicación ASP.NET establece y mantiene esta asociación en nombre de cada cliente.The SessionStateSection controls how the ASP.NET application establishes and maintains this association on behalf of each client.

Este mecanismo es muy flexible y ofrece la posibilidad de hospedar información de estado de sesión fuera de proceso y realizar un seguimiento del estado sin usar cookies, entre otras cosas.This mechanism is very flexible and gives you the ability to host session-state information out of process and to track state without using cookies, among other things.

Constructores

SessionStateSection()

Inicializa una nueva instancia de la clase SessionStateSection.Initializes a new instance of the SessionStateSection class.

Propiedades

AllowCustomSqlDatabase

Obtiene o establece un valor que indica si el usuario puede especificar el valor de catálogo inicial en la propiedad SqlConnectionString.Gets or sets a value indicating whether the user can specify the initial catalog value in the SqlConnectionString property.

CompressionEnabled

Obtiene o establece un valor que indica si la compresión está habilitada para los datos de estado de sesión.Gets or sets a value that indicates whether compression is enabled for session-state data.

Cookieless

Obtiene o establece un valor que indica si se van a utilizar cookies para identificar las sesiones de cliente.Gets or sets a value indicating whether cookies are used to identify client sessions.

CookieName

Obtiene o establece el nombre de cookie.Gets or sets the cookie name.

CookieSameSite

Obtiene o establece el valor del atributo SameSite de la cookie.Gets or sets the value for the SameSite attribute of the 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.Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Heredado de ConfigurationElement)
CustomProvider

Obtiene o establece el nombre del proveedor personalizado de la colección Providers.Gets or sets the name of the custom provider from the Providers collection.

ElementInformation

Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement.Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Heredado de ConfigurationElement)
ElementProperty

Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement.Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Heredado de ConfigurationElement)
EvaluationContext

Obtiene el objeto ContextInformation para el objeto ConfigurationElement.Gets the ContextInformation object for the ConfigurationElement object.

(Heredado de ConfigurationElement)
HasContext

Obtiene un valor que indica si la propiedad CurrentConfiguration es null.Gets a value that indicates whether the CurrentConfiguration property is null.

(Heredado de ConfigurationElement)
Item[ConfigurationProperty]

Obtiene o establece una propiedad o atributo de este elemento de configuración.Gets or sets a property or attribute of this configuration element.

(Heredado de ConfigurationElement)
Item[String]

Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración.Gets or sets a property, attribute, or child element of this configuration element.

(Heredado de ConfigurationElement)
LockAllAttributesExcept

Obtiene la colección de atributos bloqueados.Gets the collection of locked attributes.

(Heredado de ConfigurationElement)
LockAllElementsExcept

Obtiene la colección de elementos bloqueados.Gets the collection of locked elements.

(Heredado de ConfigurationElement)
LockAttributes

Obtiene la colección de atributos bloqueados.Gets the collection of locked attributes.

(Heredado de ConfigurationElement)
LockElements

Obtiene la colección de elementos bloqueados.Gets the collection of locked elements.

(Heredado de ConfigurationElement)
LockItem

Obtiene o establece un valor que indica si el elemento está bloqueado.Gets or sets a value indicating whether the element is locked.

(Heredado de ConfigurationElement)
Mode

Obtiene o establece un valor que especifica dónde se almacenará el estado de sesión.Gets or sets a value specifying where to store the session state.

PartitionResolverType

Obtiene o establece un valor que especifica dónde se almacenará el estado de sesión.Gets or sets a value specifying where to store the session state.

Properties

Obtiene la colección de propiedades.Gets the collection of properties.

(Heredado de ConfigurationElement)
Providers

Obtiene los proveedores de ProviderSettingsCollection actuales.Gets the current ProviderSettingsCollection providers.

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.Gets or sets a value indicating whether the session Id will be re-issued when an expired session ID is specified by the client.

SectionInformation

Obtiene un objeto SectionInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationSection.Gets a SectionInformation object that contains the non-customizable information and functionality of the ConfigurationSection object.

(Heredado de ConfigurationSection)
SessionIDManagerType

Obtiene o establece un valor que especifica el tipo completo del administrador de id. de sesión.Gets or sets a value specifying the fully qualified type of session ID Manager.

SqlCommandTimeout

Obtiene o establece el tiempo de espera de los comandos SQL en el modo de estado de sesión de SQL Server.Gets or sets the duration time-out for the SQL commands using the SQL Server session state mode.

SqlConnectionRetryInterval

Obtiene o establece el intervalo de tiempo que debe transcurrir antes de que ASP.NET vuelva a conectarse a la base de datos.Gets or sets the time interval that should elapse before ASP.NET reconnects to the database.

SqlConnectionString

Obtiene o establece la cadena de conexión SQL.Gets or sets the SQL connection string.

StateConnectionString

Obtiene o establece la cadena de conexión del servidor de estado.Gets or sets the state server connection string.

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.Gets or sets the amount of time the network connection between the Web server and the state server can remain idle.

Timeout

Obtiene o establece el tiempo de espera de la sesión.Gets or sets the session time-out.

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.Gets or sets a value specifying the whether the session state will use client impersonation when available, or will always revert to the hosting identity.

Métodos

DeserializeElement(XmlReader, Boolean)

Lee XML del archivo de configuración.Reads XML from the configuration file.

(Heredado de ConfigurationElement)
DeserializeSection(XmlReader)

Lee XML del archivo de configuración.Reads XML from the configuration file.

(Heredado de ConfigurationSection)
Equals(Object)

Compara la instancia actual de ConfigurationElement con el objeto especificado.Compares the current ConfigurationElement instance to the specified object.

(Heredado de ConfigurationElement)
GetHashCode()

Obtiene un valor único que representa la instancia actual de ConfigurationElement.Gets a unique value representing the current ConfigurationElement instance.

(Heredado de ConfigurationElement)
GetRuntimeObject()

Devuelve un objeto personalizado cuando se reemplaza en una clase derivada.Returns a custom object when overridden in a derived class.

(Heredado de ConfigurationSection)
GetTransformedAssemblyString(String)

Devuelve la versión transformada del nombre de ensamblado especificado.Returns the transformed version of the specified assembly name.

(Heredado de ConfigurationElement)
GetTransformedTypeString(String)

Devuelve la versión transformada del nombre de tipo especificado.Returns the transformed version of the specified type name.

(Heredado de ConfigurationElement)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
Init()

Establece el objeto ConfigurationElement en su estado inicial.Sets the ConfigurationElement object to its initial state.

(Heredado de ConfigurationElement)
InitializeDefault()

Se utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement.Used to initialize a default set of values for the ConfigurationElement object.

(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.Indicates whether this configuration element has been modified since it was last saved or loaded when implemented in a derived class.

(Heredado de ConfigurationSection)
IsReadOnly()

Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura.Gets a value indicating whether the ConfigurationElement object is read-only.

(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.Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Heredado de ConfigurationElement)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnDeserializeUnrecognizedAttribute(String, String)

Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización.Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Heredado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Obtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización.Gets a value indicating whether an unknown element is encountered during deserialization.

(Heredado de ConfigurationElement)
OnRequiredPropertyNotFound(String)

Se inicia una excepción cuando no se encuentra una propiedad necesaria.Throws an exception when a required property is not found.

(Heredado de ConfigurationElement)
PostDeserialize()

Se llama a este método después de la deserialización.Called after deserialization.

(Heredado de ConfigurationElement)
PreSerialize(XmlWriter)

Se llama a este método antes de la serialización.Called before serialization.

(Heredado de ConfigurationElement)
Reset(ConfigurationElement)

Restablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades.Resets the internal state of the ConfigurationElement object, including the locks and the properties collections.

(Heredado de ConfigurationElement)
ResetModified()

Restablece el valor del método IsModified() en false cuando se implementa en una clase derivada.Resets the value of the IsModified() method to false when implemented in a derived class.

(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.Writes the contents of this configuration element to the configuration file when implemented in a derived class.

(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.Creates an XML string containing an unmerged view of the ConfigurationSection object as a single section to write to a file.

(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.Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Heredado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Establece una propiedad en el valor especificado.Sets a property to the specified value.

(Heredado de ConfigurationElement)
SetReadOnly()

Establece la propiedad IsReadOnly() para el objeto ConfigurationElement y todos los subelementos.Sets the IsReadOnly() property for the ConfigurationElement object and all subelements.

(Heredado de ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Indica si se debe serializar el elemento especificado cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework.NET Framework.Indicates whether the specified element should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.NET Framework.

(Heredado de ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Indica si se debe serializar la propiedad especificada cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework.NET Framework.Indicates whether the specified property should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.NET Framework.

(Heredado de ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)

Indica si se debe serializar la instancia actual de ConfigurationSection cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework.NET Framework.Indicates whether the current ConfigurationSection instance should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.NET Framework.

(Heredado de ConfigurationSection)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Modifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar.Modifies the ConfigurationElement object to remove all values that should not be saved.

(Heredado de ConfigurationElement)

Se aplica a

Consulte también: