SessionStateSection Klass

Definition

Namnområde:: System.Web.Configuration

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Konfigurerar sessionstillståndet för ett webbprogram.

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

Arv: Object

ConfigurationElement

ConfigurationSection
SessionStateSection

Exempel

Det här avsnittet innehåller två kodexempel. Den första visar hur du anger värden deklarativt för flera attribut i sessionState avsnittet, som också kan nås som medlemmar i SessionStateSection klassen. Den andra visar hur du SessionStateSection använder klassen.

Följande konfigurationsfilexempel visar hur du anger värden deklarativt för sessionState avsnittet.

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

Följande kodexempel visar hur du SessionStateSection använder klassen.

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

Kommentarer

Klassen SessionStateSection refererar till elementet i Machine.config- eller Web.config konfigurationsfilen som identifieras av taggen sessionState .

När en ny klient börjar interagera med ett webbprogram utfärdas ett sessions-ID och associeras med alla efterföljande begäranden från samma klient under den tid då sessionen är giltig. Det här ID:t används för att underhålla serversidans tillstånd som är associerat med klientsessionen mellan begäranden. SessionStateSection styr hur ASP.NET-programmet upprättar och underhåller den här associationen för varje klients räkning.

Den här mekanismen är mycket flexibel och ger dig möjlighet att vara värd för sessionstillståndsinformation ur processen och spåra tillstånd utan att använda cookies, bland annat.

Konstruktorer

Name	Description
SessionStateSection()	Initierar en ny instans av SessionStateSection klassen.

Egenskaper

Name	Description
AllowCustomSqlDatabase	Hämtar eller anger ett värde som anger om användaren kan ange det ursprungliga katalogvärdet i SqlConnectionString egenskapen.
CompressionEnabled	Hämtar eller anger ett värde som anger om komprimering är aktiverat för sessionstillståndsdata.
Cookieless	Hämtar eller anger ett värde som anger om cookies används för att identifiera klientsessioner.
CookieName	Hämtar eller anger cookienamnet.
CookieSameSite	Hämtar eller anger värdet för attributet SameSite för cookien.
CurrentConfiguration	Hämtar en referens till den översta instansen Configuration som representerar konfigurationshierarkin som den aktuella ConfigurationElement instansen tillhör. (Ärvd från ConfigurationElement)
CustomProvider	Hämtar eller anger namnet på den anpassade providern från Providers samlingen.
ElementInformation	Hämtar ett ElementInformation objekt som innehåller den icke-anpassningsbara informationen och funktionerna i ConfigurationElement objektet. (Ärvd från ConfigurationElement)
ElementProperty	Hämtar objektet ConfigurationElementProperty som representerar ConfigurationElement själva objektet. (Ärvd från ConfigurationElement)
EvaluationContext	Hämtar ContextInformation-objektet för ConfigurationElement-objektet. (Ärvd från ConfigurationElement)
HasContext	Hämtar ett värde som anger om egenskapen CurrentConfiguration är `null`. (Ärvd från ConfigurationElement)
Item[ConfigurationProperty]	Hämtar eller anger en egenskap eller ett attribut för det här konfigurationselementet. (Ärvd från ConfigurationElement)
Item[String]	Hämtar eller anger en egenskap, ett attribut eller ett underordnat element i det här konfigurationselementet. (Ärvd från ConfigurationElement)
LockAllAttributesExcept	Hämtar samlingen med låsta attribut. (Ärvd från ConfigurationElement)
LockAllElementsExcept	Hämtar samlingen med låsta element. (Ärvd från ConfigurationElement)
LockAttributes	Hämtar samlingen med låsta attribut. (Ärvd från ConfigurationElement)
LockElements	Hämtar samlingen med låsta element. (Ärvd från ConfigurationElement)
LockItem	Hämtar eller anger ett värde som anger om elementet är låst. (Ärvd från ConfigurationElement)
Mode	Hämtar eller anger ett värde som anger var sessionstillståndet ska lagras.
PartitionResolverType	Hämtar eller anger ett värde som anger var sessionstillståndet ska lagras.
Properties	Hämtar samlingen med egenskaper. (Ärvd från ConfigurationElement)
Providers	Hämtar de aktuella ProviderSettingsCollection leverantörerna.
RegenerateExpiredSessionId	Hämtar eller anger ett värde som anger om sessions-ID:t kommer att utfärdas igen när ett sessions-ID som har upphört att gälla anges av klienten.
SectionInformation	Hämtar ett SectionInformation objekt som innehåller den icke-anpassningsbara informationen och funktionerna i ConfigurationSection objektet. (Ärvd från ConfigurationSection)
SessionIDManagerType	Hämtar eller anger ett värde som anger den fullständigt kvalificerade typen av sessions-ID Manager.
SqlCommandTimeout	Hämtar eller anger tidsgränsen för varaktigheten för SQL-kommandona med hjälp av SQL Server sessionstillståndsläge.
SqlConnectionRetryInterval	Hämtar eller anger det tidsintervall som ska förflutit innan ASP.NET återansluter till databasen.
SqlConnectionString	Hämtar eller anger SQL-reťazec pripojenia.
StateConnectionString	Hämtar eller anger tillståndsservern reťazec pripojenia.
StateNetworkTimeout	Hämtar eller anger hur lång tid nätverksanslutningen mellan webbservern och tillståndsservern kan förbli inaktiv.
Timeout	Hämtar eller anger tidsgränsen för sessionen.
UseHostingIdentity	Hämtar eller anger ett värde som anger om sessionstillståndet ska använda klientpersonifiering när det är tillgängligt eller alltid återgår till värdidentiteten.

Metoder

Name	Description
DeserializeElement(XmlReader, Boolean)	Läser XML från konfigurationsfilen. (Ärvd från ConfigurationElement)
DeserializeSection(XmlReader)	Läser XML från konfigurationsfilen. (Ärvd från ConfigurationSection)
Equals(Object)	Jämför den aktuella ConfigurationElement instansen med det angivna objektet. (Ärvd från ConfigurationElement)
GetHashCode()	Hämtar ett unikt värde som representerar den aktuella ConfigurationElement instansen. (Ärvd från ConfigurationElement)
GetRuntimeObject()	Returnerar ett anpassat objekt när det åsidosättas i en härledd klass. (Ärvd från ConfigurationSection)
GetTransformedAssemblyString(String)	Returnerar den transformerade versionen av det angivna sammansättningsnamnet. (Ärvd från ConfigurationElement)
GetTransformedTypeString(String)	Returnerar den transformerade versionen av det angivna typnamnet. (Ärvd från ConfigurationElement)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
Init()	Anger objektets ConfigurationElement ursprungliga tillstånd. (Ärvd från ConfigurationElement)
InitializeDefault()	Används för att initiera en standarduppsättning med värden för ConfigurationElement objektet. (Ärvd från ConfigurationElement)
IsModified()	Anger om det här konfigurationselementet har ändrats sedan det senast sparades eller lästes in när det implementerades i en härledd klass. (Ärvd från ConfigurationSection)
IsReadOnly()	Hämtar ett värde som anger om objektet ConfigurationElement är skrivskyddat. (Ärvd från ConfigurationElement)
ListErrors(IList)	Lägger till felen invalid-property i det här ConfigurationElement objektet, och i alla underelement, i den överförda listan. (Ärvd från ConfigurationElement)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnDeserializeUnrecognizedAttribute(String, String)	Hämtar ett värde som anger om ett okänt attribut påträffas under deserialiseringen. (Ärvd från ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hämtar ett värde som anger om ett okänt element påträffas under deserialiseringen. (Ärvd från ConfigurationElement)
OnRequiredPropertyNotFound(String)	Utlöser ett undantag när en obligatorisk egenskap inte hittas. (Ärvd från ConfigurationElement)
PostDeserialize()	Anropas efter deserialisering. (Ärvd från ConfigurationElement)
PreSerialize(XmlWriter)	Anropas före serialisering. (Ärvd från ConfigurationElement)
Reset(ConfigurationElement)	Återställer objektets interna tillstånd ConfigurationElement , inklusive låsen och egenskapssamlingarna. (Ärvd från ConfigurationElement)
ResetModified()	Återställer värdet för metoden till IsModified() när den `false` implementeras i en härledd klass. (Ärvd från ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Skriver innehållet i det här konfigurationselementet till konfigurationsfilen när det implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Skapar en XML-sträng som innehåller en icke-komprimerad vy av ConfigurationSection objektet som ett enda avsnitt för att skriva till en fil. (Ärvd från ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Skriver de yttre taggarna för det här konfigurationselementet till konfigurationsfilen när det implementeras i en härledd klass. (Ärvd från ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Anger en egenskap till det angivna värdet. (Ärvd från ConfigurationElement)
SetReadOnly()	Anger egenskapen IsReadOnly() för ConfigurationElement objektet och alla underelement. (Ärvd från ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Anger om det angivna elementet ska serialiseras när konfigurationsobjekthierarkin serialiseras för den angivna målversionen av .NET Framework. (Ärvd från ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Anger om den angivna egenskapen ska serialiseras när konfigurationsobjekthierarkin serialiseras för den angivna målversionen av .NET Framework. (Ärvd från ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Anger om den aktuella ConfigurationSection-instansen ska serialiseras när konfigurationsobjekthierarkin serialiseras för den angivna målversionen av .NET Framework. (Ärvd från ConfigurationSection)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändrar objektet ConfigurationElement för att ta bort alla värden som inte ska sparas. (Ärvd från ConfigurationElement)

Gäller för

Se även

HttpContext
HttpSessionState
översikt över ASP.NET tillståndshantering
Översikt över ASP.NET sessionstillstånd
Kontrollera sessionstillstånd

Feedback

Var den här sidan till hjälp?