SessionStateSection Klasse

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konfiguriert den Sitzungsstatus 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: Object

ConfigurationElement

ConfigurationSection
SessionStateSection

Beispiele

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

Das folgende Konfigurationsdateibeispiel zeigt, wie Werte deklarativ für den sessionState Abschnitt 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 einer Webanwendung interagiert, wird eine Sitzungs-ID ausgegeben und allen nachfolgenden Anforderungen desselben Clients während der Gültigkeit der Sitzung zugeordnet. Diese ID wird verwendet, um den serverseitigen Zustand beizubehalten, der der Clientsitzung über Anforderungen hinweg zugeordnet ist. Die SessionStateSection steuert, wie die ASP.NET Anwendung diese Zuordnung im Namen jedes Clients herstellt und verwaltet.

Dieser Mechanismus ist sehr flexibel und bietet Ihnen die Möglichkeit, Sitzungsstatusinformationen außerhalb des Prozesses zu hosten und den Zustand zu verfolgen, ohne Cookies zu verwenden, unter anderem.

Konstruktoren

Name	Beschreibung
SessionStateSection()	Initialisiert eine neue Instanz der SessionStateSection-Klasse.

Eigenschaften

Name	Beschreibung
AllowCustomSqlDatabase	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer den anfänglichen Katalogwert in der SqlConnectionString Eigenschaft angeben kann.
CompressionEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Komprimierung für Sitzungszustandsdaten aktiviert ist.
Cookieless	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Cookies verwendet werden, um Clientsitzungen zu identifizieren.
CookieName	Ruft den Cookienamen ab oder legt den Namen fest.
CookieSameSite	Dient zum Abrufen oder Festlegen des Werts für das SameSite-Attribut des Cookies.
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
CustomProvider	Dient zum Abrufen oder Festlegen des Namens des benutzerdefinierten Anbieters aus der Providers Auflistung.
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]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[String]	Dient zum Abrufen oder Festlegen einer Eigenschaft, eines Attributs oder eines untergeordneten Elements dieses Konfigurationselements. (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	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
Mode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo der Sitzungszustand gespeichert werden soll.
PartitionResolverType	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo der Sitzungszustand gespeichert werden soll.
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
Providers	Ruft die aktuellen ProviderSettingsCollection Anbieter ab.
RegenerateExpiredSessionId	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Sitzungs-ID erneut ausgegeben wird, wenn eine abgelaufene Sitzungs-ID vom Client angegeben wird.
SectionInformation	Ruft ein SectionInformation -Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationSection -Objekts enthält. (Geerbt von ConfigurationSection)
SessionIDManagerType	Dient zum Abrufen oder Festlegen eines Werts, der den vollqualifizierten Typ des Sitzungs-ID-Managers angibt.
SqlCommandTimeout	Dient zum Abrufen oder Festlegen des Timeouts für die SQL-Befehle mithilfe des SQL Server-Sitzungszustandsmodus.
SqlConnectionRetryInterval	Ruft das Zeitintervall ab, das verstrichen werden soll, bevor ASP.NET erneut mit der Datenbank verbunden wird, oder legt dieses fest.
SqlConnectionString	Dient zum Abrufen oder Festlegen der SQL-Verbindungszeichenfolge.
StateConnectionString	Dient zum Abrufen oder Festlegen der Verbindungszeichenfolge des Statusservers.
StateNetworkTimeout	Ruft ab oder legt fest, wie lange die Netzwerkverbindung zwischen dem Webserver und dem Statusserver im Leerlauf bleiben kann.
Timeout	Dient zum Abrufen oder Festlegen des Sitzungstimeouts.
UseHostingIdentity	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Sitzungszustand den Clientidentitätswechsel verwendet, wenn verfügbar, oder wird immer auf die Hostingidentität zurückgesetzt.

Methoden

Name	Beschreibung
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 die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement-Objekt auf den Anfangszustand 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 seit dem letzten Speichern oder Laden geändert wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationSection)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement -Objekt schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement-Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element auftritt. (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 Zustand des ConfigurationElement -Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt den Wert der IsModified()-Methode auf `false` zurück, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei, wenn es in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Erstellt eine XML-Zeichenfolge mit einer nicht zusammengeführten Ansicht des ConfigurationSection -Objekts als einzelner Abschnitt zum Schreiben in eine Datei. (Geerbt von ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (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 des .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 des .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 des .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

Feedback

War diese Seite hilfreich?