SessionStateSection Klas

Definitie

Hiermee configureert u de sessiestatus voor een webtoepassing.

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
Overname

Voorbeelden

Deze sectie bevat twee codevoorbeelden. De eerste laat zien hoe u waarden declaratief opgeeft voor verschillende kenmerken van de sessionState sectie, die ook kunnen worden geopend als leden van de SessionStateSection klasse. De tweede laat zien hoe u de SessionStateSection klasse gebruikt.

In het volgende voorbeeld van een configuratiebestand ziet u hoe u waarden declaratief opgeeft voor de sessionState sectie.

<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>

In het volgende codevoorbeeld ziet u hoe u de SessionStateSection klasse gebruikt.

// 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)

Opmerkingen

De SessionStateSection klasse verwijst naar het element in de Machine.config of Web.config configuratiebestand dat is geïdentificeerd door de sessionState tag.

Wanneer een nieuwe client met een webtoepassing begint te communiceren, wordt er een sessie-id uitgegeven en gekoppeld aan alle volgende aanvragen van dezelfde client tijdens het moment dat de sessie geldig is. Deze id wordt gebruikt om de status aan de serverzijde te behouden die is gekoppeld aan de clientsessie tussen aanvragen. De SessionStateSection bepaalt hoe de ASP.NET toepassing deze koppeling namens elke client tot stand brengt en onderhoudt.

Dit mechanisme is zeer flexibel en biedt u de mogelijkheid om sessiestatusinformatie buiten het proces te hosten en de status bij te houden zonder cookies te gebruiken, onder andere.

Constructors

Name Description
SessionStateSection()

Initialiseert een nieuw exemplaar van de SessionStateSection klasse.

Eigenschappen

Name Description
AllowCustomSqlDatabase

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebruiker de initiële cataloguswaarde in de SqlConnectionString eigenschap kan opgeven.

CompressionEnabled

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of compressie is ingeschakeld voor sessiestatusgegevens.

Cookieless

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of cookies worden gebruikt om clientsessies te identificeren.

CookieName

Hiermee haalt u de cookienaam op of stelt u deze in.

CookieSameSite

Hiermee wordt de waarde voor het kenmerk SameSite van de cookie opgehaald of ingesteld.

CurrentConfiguration

Hiermee wordt een verwijzing opgehaald naar het exemplaar op het hoogste niveau Configuration dat de configuratiehiërarchie vertegenwoordigt waartoe het huidige ConfigurationElement exemplaar behoort.

(Overgenomen van ConfigurationElement)
CustomProvider

Hiermee haalt u de naam van de aangepaste provider op uit de verzameling of stelt u deze Providers in.

ElementInformation

Hiermee haalt u een ElementInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationElement object bevat.

(Overgenomen van ConfigurationElement)
ElementProperty

Hiermee haalt u het ConfigurationElementProperty object op dat het ConfigurationElement object zelf vertegenwoordigt.

(Overgenomen van ConfigurationElement)
EvaluationContext

Hiermee haalt u het ContextInformation object voor het ConfigurationElement object op.

(Overgenomen van ConfigurationElement)
HasContext

Hiermee wordt een waarde opgehaald die aangeeft of de CurrentConfiguration eigenschap is null.

(Overgenomen van ConfigurationElement)
Item[ConfigurationProperty]

Hiermee wordt een eigenschap of kenmerk van dit configuratie-element opgehaald of ingesteld.

(Overgenomen van ConfigurationElement)
Item[String]

Hiermee wordt een eigenschap, kenmerk of onderliggend element van dit configuratie-element opgehaald of ingesteld.

(Overgenomen van ConfigurationElement)
LockAllAttributesExcept

Hiermee haalt u de verzameling vergrendelde kenmerken op.

(Overgenomen van ConfigurationElement)
LockAllElementsExcept

Hiermee haalt u de verzameling vergrendelde elementen op.

(Overgenomen van ConfigurationElement)
LockAttributes

Hiermee haalt u de verzameling vergrendelde kenmerken op.

(Overgenomen van ConfigurationElement)
LockElements

Hiermee haalt u de verzameling vergrendelde elementen op.

(Overgenomen van ConfigurationElement)
LockItem

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het element is vergrendeld.

(Overgenomen van ConfigurationElement)
Mode

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft waar de sessiestatus moet worden opgeslagen.

PartitionResolverType

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft waar de sessiestatus moet worden opgeslagen.

Properties

Hiermee haalt u de verzameling eigenschappen op.

(Overgenomen van ConfigurationElement)
Providers

Haalt de huidige ProviderSettingsCollection providers op.

RegenerateExpiredSessionId

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de sessie-id opnieuw wordt uitgegeven wanneer een verlopen sessie-id wordt opgegeven door de client.

SectionInformation

Hiermee haalt u een SectionInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationSection object bevat.

(Overgenomen van ConfigurationSection)
SessionIDManagerType

Hiermee wordt een waarde opgehaald of ingesteld die het volledig gekwalificeerde type sessie-ID Manager aangeeft.

SqlCommandTimeout

Hiermee haalt u de time-outtijd voor de SQL-opdrachten op of stelt u deze in met behulp van de modus SQL Server sessiestatus.

SqlConnectionRetryInterval

Hiermee haalt u het tijdsinterval op dat moet worden verstreken voordat ASP.NET opnieuw verbinding maakt met de database.

SqlConnectionString

Hiermee haalt u de SQL-verbindingsreeks op of stelt u deze in.

StateConnectionString

Hiermee haalt u de statusserver op of stelt u deze in verbindingsreeks.

StateNetworkTimeout

Hiermee haalt u de hoeveelheid tijd op of stelt u de netwerkverbinding tussen de webserver en de statusserver inactief.

Timeout

Hiermee haalt u de time-out van de sessie op of stelt u deze in.

UseHostingIdentity

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de sessiestatus clientimitatie gebruikt wanneer deze beschikbaar is, of die altijd wordt teruggezet naar de hostingidentiteit.

Methoden

Name Description
DeserializeElement(XmlReader, Boolean)

Leest XML uit het configuratiebestand.

(Overgenomen van ConfigurationElement)
DeserializeSection(XmlReader)

Leest XML uit het configuratiebestand.

(Overgenomen van ConfigurationSection)
Equals(Object)

Vergelijkt het huidige ConfigurationElement exemplaar met het opgegeven object.

(Overgenomen van ConfigurationElement)
GetHashCode()

Hiermee haalt u een unieke waarde op die het huidige ConfigurationElement exemplaar vertegenwoordigt.

(Overgenomen van ConfigurationElement)
GetRuntimeObject()

Retourneert een aangepast object wanneer dit wordt overschreven in een afgeleide klasse.

(Overgenomen van ConfigurationSection)
GetTransformedAssemblyString(String)

Retourneert de getransformeerde versie van de opgegeven assemblynaam.

(Overgenomen van ConfigurationElement)
GetTransformedTypeString(String)

Retourneert de getransformeerde versie van de opgegeven typenaam.

(Overgenomen van ConfigurationElement)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
Init()

Hiermee stelt u het object in op de ConfigurationElement oorspronkelijke status.

(Overgenomen van ConfigurationElement)
InitializeDefault()

Wordt gebruikt om een standaardset waarden voor het ConfigurationElement object te initialiseren.

(Overgenomen van ConfigurationElement)
IsModified()

Geeft aan of dit configuratie-element is gewijzigd sinds het voor het laatst is opgeslagen of geladen wanneer dit is geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationSection)
IsReadOnly()

Hiermee wordt een waarde opgehaald die aangeeft of het ConfigurationElement object het kenmerk Alleen-lezen heeft.

(Overgenomen van ConfigurationElement)
ListErrors(IList)

Voegt de fouten met ongeldige eigenschappen in dit ConfigurationElement object en in alle subelementen toe aan de doorgegeven lijst.

(Overgenomen van ConfigurationElement)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnDeserializeUnrecognizedAttribute(String, String)

Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend kenmerk wordt aangetroffen tijdens deserialisatie.

(Overgenomen van ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend element wordt aangetroffen tijdens deserialisatie.

(Overgenomen van ConfigurationElement)
OnRequiredPropertyNotFound(String)

Genereert een uitzondering wanneer een vereiste eigenschap niet wordt gevonden.

(Overgenomen van ConfigurationElement)
PostDeserialize()

Gebeld na ontserialisatie.

(Overgenomen van ConfigurationElement)
PreSerialize(XmlWriter)

Aangeroepen vóór serialisatie.

(Overgenomen van ConfigurationElement)
Reset(ConfigurationElement)

Hiermee stelt u de interne status van het ConfigurationElement object opnieuw in, inclusief de vergrendelingen en de eigenschappenverzamelingen.

(Overgenomen van ConfigurationElement)
ResetModified()

Hiermee stelt u de waarde van de methode IsModified() opnieuw in wanneer deze false wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationSection)
SerializeElement(XmlWriter, Boolean)

Schrijft de inhoud van dit configuratie-element naar het configuratiebestand wanneer deze wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)

Hiermee maakt u een XML-tekenreeks met een niet-gekoppelde weergave van het ConfigurationSection object als één sectie om naar een bestand te schrijven.

(Overgenomen van ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)

Hiermee schrijft u de buitenste tags van dit configuratie-element naar het configuratiebestand wanneer het wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Hiermee stelt u een eigenschap in op de opgegeven waarde.

(Overgenomen van ConfigurationElement)
SetReadOnly()

Hiermee stelt u de IsReadOnly() eigenschap voor het ConfigurationElement object en alle subelementen in.

(Overgenomen van ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Geeft aan of het opgegeven element moet worden geserialiseerd wanneer de hiërarchie van het configuratieobject wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework.

(Overgenomen van ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Geeft aan of de opgegeven eigenschap moet worden geserialiseerd wanneer de configuratieobjecthiërarchie wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework.

(Overgenomen van ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)

Hiermee wordt aangegeven of de huidige ConfigurationSection-instantie moet worden geserialiseerd wanneer de hiërarchie van het configuratieobject wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework.

(Overgenomen van ConfigurationSection)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Hiermee wijzigt u het ConfigurationElement object om alle waarden te verwijderen die niet mogen worden opgeslagen.

(Overgenomen van ConfigurationElement)

Van toepassing op

Zie ook