Freigeben über


SessionStateModule.End-Ereignis

Tritt bei Sitzungsende ein.

Namespace: System.Web.SessionState
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Event End As EventHandler
'Usage
Dim instance As SessionStateModule
Dim handler As EventHandler

AddHandler instance.End, handler
public event EventHandler End
public:
event EventHandler^ End {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}
/** @event */
public void add_End (EventHandler value)

/** @event */
public void remove_End (EventHandler value)
JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Das End-Ereignis wird am Ende einer Anforderung ausgelöst, wenn die Abandon-Methode aufgerufen wurde oder die Sitzung abgelaufen ist. Eine Sitzung läuft ab, wenn die in der Timeout-Eigenschaft angegebene Anzahl von Minuten verstreicht, ohne dass eine weitere Anforderung für die Sitzung erfolgt.

Das Session_OnEnd-Ereignis wird zum Bereinigen einer Sitzung verwendet, z. B. zum Freigeben von Ressourcen, die von der Sitzung verwendet wurden.

Sie können einen Handler für das End-Ereignis angeben, indem Sie der Datei Global.asax eine öffentliche Unterroutine mit dem Namen Session_OnEnd hinzufügen.

Hinweis

Das Session_OnEnd-Ereignis wird nur unterstützt, wenn der HttpSessionState.Mode-Eigenschaftenwert für den Sitzungszustand den Standardwert InProc aufweist. Wenn Mode für den Sitzungszustand auf StateServer oder SQLServer festgelegt ist, wird das Session_OnEnd-Ereignis aus der Datei Global.asax ignoriert. Wenn der Mode-Eigenschaftenwert für den Sitzungszustand Custom ist, hängt es vom benutzerdefinierten Anbieter für den Sitzungszustandsspeicher ab, ob das Session_OnEnd-Ereignis unterstützt wird.

Obwohl das End-Ereignis öffentlich ist, kann es nur behandelt werden, wenn der Datei Global.asax ein Ereignishandler hinzugefügt wird. Diese Beschränkung besteht, weil HttpApplication-Instanzen aus Leistungsgründen wiederverwendet werden. Wenn eine Sitzung abläuft, wird nur das in der Datei Global.asax angegebene Session_OnEnd-Ereignis ausgeführt, um zu verhindern, dass im Code ein End-Ereignishandler aufgerufen wird, der einer gegenwärtig verwendeten HttpApplication-Instanz zugeordnet ist.

Weitere Informationen über die Datei Global.asax finden Sie unter Syntax von "Global.asax".

Beispiel

Im folgenden Codebeispiel wird der Inhalt der Datei Global.asax veranschaulicht, in der das Session_OnStart-Ereignis und das Session_OnEnd-Ereignis definiert sind.

<script language="VB" runat="server">
Public Sub Session_OnStart()

End Sub

Public Sub Session_OnEnd()

End Sub
</script>
<script language="C#" runat="server">
public void Session_OnStart()
{

}

public void Session_OnEnd()
{

}
</script>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SessionStateModule-Klasse
SessionStateModule-Member
System.Web.SessionState-Namespace

Weitere Ressourcen

ASP.NET-Sitzungszustand