SessionStateSection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Configura o estado da sessão para uma aplicação Web.
public ref class SessionStateSection sealed : System::Configuration::ConfigurationSectionpublic sealed class SessionStateSection : System.Configuration.ConfigurationSectiontype SessionStateSection = class
inherit ConfigurationSectionPublic NotInheritable Class SessionStateSection
Inherits ConfigurationSection- Herança
Exemplos
Esta secção fornece dois exemplos de código. O primeiro demonstra como especificar valores declarativamente para vários atributos da sessionState secção, que também podem ser acedidos como membros da SessionStateSection classe. A segunda mostra como usar a SessionStateSection turma.
O exemplo seguinte do ficheiro de configuração mostra como especificar valores declarativamente para a sessionState secção.
<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>
O exemplo de código seguinte demonstra como usar a SessionStateSection classe.
// 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)
Observações
A SessionStateSection classe refere-se ao elemento no ficheiro de configuração Machine.config ou Web.config identificado pela sessionState etiqueta.
Quando um novo cliente começa a interagir com uma aplicação Web, é emitido um ID de sessão associado a todos os pedidos subsequentes do mesmo cliente durante o tempo em que a sessão é válida. Este ID é usado para manter o estado do lado do servidor associado à sessão do cliente entre pedidos. O SessionStateSection controla como a aplicação ASP.NET estabelece e mantém esta associação em nome de cada cliente.
Este mecanismo é muito flexível e dá-lhe a capacidade de alojar informação do estado da sessão fora do processo e de acompanhar o estado sem usar cookies, entre outras coisas.
Construtores
| Name | Description |
|---|---|
| SessionStateSection() |
Inicializa uma nova instância da SessionStateSection classe. |
Propriedades
| Name | Description |
|---|---|
| AllowCustomSqlDatabase |
Recebe ou define um valor que indica se o utilizador pode especificar o valor inicial do catálogo na SqlConnectionString propriedade. |
| CompressionEnabled |
Recebe ou define um valor que indica se a compressão está ativada para dados de estado da sessão. |
| Cookieless |
Recebe ou define um valor que indica se cookies são usados para identificar sessões do cliente. |
| CookieName |
Recebe ou define o nome da bolacha. |
| CookieSameSite |
Obtém ou define o valor do atributo SameSite do cookie. |
| CurrentConfiguration |
Obtém uma referência à instância de topo Configuration que representa a hierarquia de configuração a que pertence a instância atual ConfigurationElement . (Herdado de ConfigurationElement) |
| CustomProvider |
Obtém ou define o nome do fornecedor personalizado da Providers coleção. |
| ElementInformation |
Obtém um ElementInformation objeto que contém a informação e funcionalidade não personalizáveis do ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| ElementProperty |
Obtém o ConfigurationElementProperty objeto que representa o ConfigurationElement próprio objeto. (Herdado de ConfigurationElement) |
| EvaluationContext |
Obtém o ContextInformation objeto para o ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| HasContext |
Obtém um valor que indica se a CurrentConfiguration propriedade é |
| Item[ConfigurationProperty] |
Obtém ou define uma propriedade ou atributo deste elemento de configuração. (Herdado de ConfigurationElement) |
| Item[String] |
Obtém ou define uma propriedade, atributo ou elemento filho deste elemento de configuração. (Herdado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockAllElementsExcept |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockAttributes |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockElements |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockItem |
Recebe ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement) |
| Mode |
Recebe ou define um valor que especifica onde guardar o estado da sessão. |
| PartitionResolverType |
Recebe ou define um valor que especifica onde guardar o estado da sessão. |
| Properties |
Recebe a coleção de propriedades. (Herdado de ConfigurationElement) |
| Providers |
Obtém os prestadores atuais ProviderSettingsCollection . |
| RegenerateExpiredSessionId |
Recebe ou define um valor que indica se o ID de sessão será reemitido quando um ID de sessão expirado for especificado pelo cliente. |
| SectionInformation |
Obtém um SectionInformation objeto que contém a informação e funcionalidade não personalizáveis do ConfigurationSection objeto. (Herdado de ConfigurationSection) |
| SessionIDManagerType |
Recebe ou define um valor que especifica o tipo totalmente qualificado de Gestor de ID de sessão. |
| SqlCommandTimeout |
Obtém ou define o tempo de espera para os comandos SQL usando o modo de estado de sessão do SQL Server. |
| SqlConnectionRetryInterval |
Obtém ou define o intervalo de tempo que deverá decorrer antes do ASP.NET se reconectar à base de dados. |
| SqlConnectionString |
Obtém ou define a cadeia de ligação SQL. |
| StateConnectionString |
Obtém ou define a cadeia de ligação de estado do servidor. |
| StateNetworkTimeout |
Obtém ou define o tempo em que a ligação de rede entre o servidor Web e o servidor de estado pode permanecer inativa. |
| Timeout |
Obtém ou define o tempo de descanso da sessão. |
| UseHostingIdentity |
Recebe ou define um valor que especifica se o estado da sessão usará a personificação do cliente quando disponível, ou se reverterá sempre para a identidade do alojamento. |
Métodos
| Name | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lê XML a partir do ficheiro de configuração. (Herdado de ConfigurationElement) |
| DeserializeSection(XmlReader) |
Lê XML a partir do ficheiro de configuração. (Herdado de ConfigurationSection) |
| Equals(Object) |
Compara a instância atual ConfigurationElement com o objeto especificado. (Herdado de ConfigurationElement) |
| GetHashCode() |
Obtém um valor único que representa a instância atual ConfigurationElement . (Herdado de ConfigurationElement) |
| GetRuntimeObject() |
Devolve um objeto personalizado quando sobrescrito numa classe derivada. (Herdado de ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Devolve a versão transformada do nome da assembleia especificado. (Herdado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Devolve a versão transformada do nome do tipo especificado. (Herdado de ConfigurationElement) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Init() |
Define o ConfigurationElement objeto para o seu estado inicial. (Herdado de ConfigurationElement) |
| InitializeDefault() |
Usado para inicializar um conjunto padrão de valores para o ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| IsModified() |
Indica se este elemento de configuração foi modificado desde a última vez que foi guardado ou carregado quando implementado numa classe derivada. (Herdado de ConfigurationSection) |
| IsReadOnly() |
Recebe um valor que indica se o ConfigurationElement objeto é apenas de leitura. (Herdado de ConfigurationElement) |
| ListErrors(IList) |
Adiciona os erros de propriedades inválidas neste ConfigurationElement objeto, e em todos os subelementos, à lista passada. (Herdado de ConfigurationElement) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Recebe um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtém um valor que indica se um elemento desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Lança uma exceção quando uma propriedade exigida não é encontrada. (Herdado de ConfigurationElement) |
| PostDeserialize() |
Chamada após desserialização. (Herdado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chamado antes da serialização. (Herdado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Reinicia o estado interno do ConfigurationElement objeto, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement) |
| ResetModified() |
Redefine o valor do IsModified() método para |
| SerializeElement(XmlWriter, Boolean) |
Escreve o conteúdo deste elemento de configuração no ficheiro de configuração quando implementado numa classe derivada. (Herdado de ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Cria uma string XML contendo uma vista não fundida do ConfigurationSection objeto como uma única secção para escrever num ficheiro. (Herdado de ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Escreve as etiquetas exteriores deste elemento de configuração no ficheiro de configuração quando implementado numa classe derivada. (Herdado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement) |
| SetReadOnly() |
Define a IsReadOnly() propriedade para o ConfigurationElement objeto e todos os subelementos. (Herdado de ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica se o elemento especificado deve ser serializado quando a hierarquia de objetos de configuração é serializada para a versão alvo especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica se a propriedade especificada deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão alvo especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica se a instância atual ConfigurationSection deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão alvo especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica o ConfigurationElement objeto para remover todos os valores que não deveriam ser guardados. (Herdado de ConfigurationElement) |