SessionStateSection Klasse

Definition

Konfiguriert den Sitzungszustand für eine Webanwendung.

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
Vererbung

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Die erste veranschaulicht, wie Werte deklarativ für mehrere Attribute des Abschnitts angegeben werden, auf die sessionState auch als Member der SessionStateSection -Klasse zugegriffen werden kann. Die zweite veranschaulicht die Verwendung der SessionStateSection -Klasse.

Im folgenden Beispiel für die Konfigurationsdatei wird gezeigt, wie Werte für den sessionState Abschnitt deklarativ angegeben werden.

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

Im folgenden Codebeispiel wird die Verwendung der SessionStateSection -Klasse veranschaulicht.

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

Hinweise

Die SessionStateSection -Klasse bezieht sich auf das Element in der Machine.config oder Web.config Konfigurationsdatei, die durch das sessionState Tag identifiziert wird.

Wenn ein neuer Client mit der Interaktion mit einer Webanwendung beginnt, wird eine Sitzungs-ID ausgegeben und allen nachfolgenden Anforderungen desselben Clients zugeordnet, während die Sitzung gültig ist. Diese ID wird verwendet, um den serverseitigen Zustand beizubehalten, der der Clientsitzung über Anforderungen hinweg zugeordnet ist. Steuert SessionStateSection , wie die ASP.NET Anwendung diese Zuordnung im Namen jedes Clients erstellt und verwaltet.

Dieser Mechanismus ist sehr flexibel und bietet Ihnen unter anderem die Möglichkeit, Sitzungszustandsinformationen außerhalb des Prozesses zu hosten und den Zustand ohne Verwendung von Cookies nachzuverfolgen.

Konstruktoren

SessionStateSection()

Initialisiert eine neue Instanz der SessionStateSection-Klasse.

Eigenschaften

AllowCustomSqlDatabase

Ruft einen Wert ab, der angibt, ob der Benutzer den Wert für den ursprünglichen Katalog in der SqlConnectionString-Eigenschaft angeben kann, oder legt diesen fest.

CompressionEnabled

Ruft einen Wert ab, der angibt, ob die Komprimierung für Sitzungszustandsdaten aktiviert ist, oder legt diesen fest.

Cookieless

Ruft einen Wert ab, der angibt, ob zum Identifizieren von Clientsitzungen Cookies verwendet werden, oder legt diesen fest.

CookieName

Ruft den Namen des Cookies ab oder legt diesen fest.

CookieSameSite

Ruft den Wert des Attributs „SameSite“ des Cookies ab oder legt ihn fest.

CurrentConfiguration

Ruft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört.

(Geerbt von ConfigurationElement)
CustomProvider

Ruft den Namen des benutzerdefinierten Anbieters aus der Providers-Auflistung ab oder legt diesen fest.

ElementInformation

Ruft ein ElementInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement-Objekts enthält.

(Geerbt von ConfigurationElement)
ElementProperty

Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt.

(Geerbt von ConfigurationElement)
EvaluationContext

Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab.

(Geerbt von ConfigurationElement)
HasContext

Ruft einen Wert ab, der angibt, ob die CurrentConfiguration-Eigenschaft null ist.

(Geerbt von ConfigurationElement)
Item[ConfigurationProperty]

Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest.

(Geerbt von ConfigurationElement)
Item[String]

Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest.

(Geerbt von ConfigurationElement)
LockAllAttributesExcept

Ruft die Auflistung gesperrter Attribute ab.

(Geerbt von ConfigurationElement)
LockAllElementsExcept

Ruft die Auflistung gesperrter Elemente ab.

(Geerbt von ConfigurationElement)
LockAttributes

Ruft die Auflistung gesperrter Attribute ab.

(Geerbt von ConfigurationElement)
LockElements

Ruft die Auflistung gesperrter Elemente ab.

(Geerbt von ConfigurationElement)
LockItem

Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest.

(Geerbt von ConfigurationElement)
Mode

Ruft einen Wert ab, der den Speicherort des Sitzungszustands angibt, oder legt diesen fest.

PartitionResolverType

Ruft einen Wert ab, der den Speicherort des Sitzungszustands angibt, oder legt diesen fest.

Properties

Ruft die Auflistung von Eigenschaften ab.

(Geerbt von ConfigurationElement)
Providers

Ruft die aktuellen ProviderSettingsCollection-Anbieter ab.

RegenerateExpiredSessionId

Ruft einen Wert ab, der angibt, ob die Sitzungs-ID erneut ausgegeben wird, wenn vom Client eine abgelaufene Sitzungs-ID angegeben wurde, oder legt diesen fest.

SectionInformation

Ruft ein SectionInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationSection-Objekts enthält.

(Geerbt von ConfigurationSection)
SessionIDManagerType

Ruft einen Wert ab, der den voll qualifizierten Typ des Sitzungs-ID-Managers angibt, oder legt diesen fest.

SqlCommandTimeout

Ruft das Timeout für die SQL-Befehle mit dem SQL Server-Sitzungszustandsmodus ab, oder legt dieses fest.

SqlConnectionRetryInterval

Ruft das Zeitintervall ab, nach dessen Ablauf ASP.NET erneut eine Verbindung mit der Datenbank herstellen soll, oder legt dieses fest.

SqlConnectionString

Ruft die SQL-Verbindungszeichenfolge ab oder legt diese fest.

StateConnectionString

Ruft die Verbindungszeichenfolge für den Zustandsserver ab oder legt diese fest.

StateNetworkTimeout

Ruft die Zeitspanne ab, während der die Netzwerkverbindung zwischen Webserver und Zustandsserver im Leerlauf bleiben kann, oder legt diese fest.

Timeout

Ruft das Sitzungstimeout ab oder legt dieses fest.

UseHostingIdentity

Ruft einen Wert ab, der angibt, ob für den Sitzungszustand ggf. Clientidentitätswechsel verwendet oder immer zur Hostidentität zurückgekehrt wird, oder legt diesen fest.

Methoden

DeserializeElement(XmlReader, Boolean)

Liest XML aus der Konfigurationsdatei.

(Geerbt von ConfigurationElement)
DeserializeSection(XmlReader)

Liest XML aus der Konfigurationsdatei.

(Geerbt von ConfigurationSection)
Equals(Object)

Vergleicht die aktuelle ConfigurationElement-Instanz mit dem angegebenen Objekt.

(Geerbt von ConfigurationElement)
GetHashCode()

Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement-Instanz darstellt.

(Geerbt von ConfigurationElement)
GetRuntimeObject()

Gibt ein benutzerdefiniertes Objekt zurück, wenn es in einer abgeleiteten Klasse überschrieben wird.

(Geerbt von ConfigurationSection)
GetTransformedAssemblyString(String)

Gibt die transformierte Version des angegebenen Assemblynamens zurück.

(Geerbt von ConfigurationElement)
GetTransformedTypeString(String)

Gibt die transformierte Version des angegebenen Typnamens zurück.

(Geerbt von ConfigurationElement)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Init()

Legt für das ConfigurationElement-Objekt den Ausgangszustand fest.

(Geerbt von ConfigurationElement)
InitializeDefault()

Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren.

(Geerbt von ConfigurationElement)
IsModified()

Gibt an, ob dieses Konfigurationselement geändert wurde, seit es zuletzt gespeichert oder geladen wurde, wenn es in einer abgeleiteten Klasse implementiert wurde.

(Geerbt von ConfigurationSection)
IsReadOnly()

Ruft einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist.

(Geerbt von ConfigurationElement)
ListErrors(IList)

Fügt die Fehler über ungültige Eigenschaften in diesem ConfigurationElement-Objekt und in allen Unterelementen der übergebenen Liste hinzu.

(Geerbt von ConfigurationElement)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)

Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist.

(Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element aufgetreten ist.

(Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)

Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird.

(Geerbt von ConfigurationElement)
PostDeserialize()

Wird nach der Deserialisierung aufgerufen.

(Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)

Wird vor der Serialisierung aufgerufen.

(Geerbt von ConfigurationElement)
Reset(ConfigurationElement)

Setzt den internen Status dieses ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen.

(Geerbt von ConfigurationElement)
ResetModified()

Setzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified()-Methode auf false zurück.

(Geerbt von ConfigurationSection)
SerializeElement(XmlWriter, Boolean)

Schreibt bei Implementierung in einer abgeleiteten Klasse den Inhalt dieses Konfigurationselements in die Konfigurationsdatei.

(Geerbt von ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)

Erstellt eine XML-Zeichenfolge mit einer nicht zusammengeführten Ansicht des ConfigurationSection-Objekts als einzelnem Abschnitt, der in einer Datei geschrieben werden soll.

(Geerbt von ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)

Schreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei.

(Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Legt eine Eigenschaft auf den angegebenen Wert fest.

(Geerbt von ConfigurationElement)
SetReadOnly()

Legt die IsReadOnly()-Eigenschaft für das ConfigurationElement-Objekt und alle Unterelemente fest.

(Geerbt von ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Gibt an, ob das angegebene Element serialisiert werden soll, wenn die Konfigurationsobjekthierarchie für die angegebene Zielversion von .NET Framework serialisiert wird.

(Geerbt von ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Gibt an, ob die angegebene Eigenschaft serialisiert werden soll, wenn die Konfigurationsobjekthierarchie für die angegebene Zielversion von .NET Framework serialisiert wird.

(Geerbt von ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)

Gibt an, ob die aktuelle ConfigurationSection Instanz serialisiert werden soll, wenn die Konfigurationsobjekthierarchie für die angegebene Zielversion von .NET Framework serialisiert wird.

(Geerbt von ConfigurationSection)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Ändert das ConfigurationElement-Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen.

(Geerbt von ConfigurationElement)

Gilt für:

Weitere Informationen