hostingEnvironment-Element (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Definiert die Konfigurationseinstellungen, die das Verhalten der Hostumgebung der Anwendung steuern.
<hostingEnvironment
idleTimeout="HH:MM:SS"
shadowCopyBinAssemblies="true|false"
shutdownTimeout="number"
urlMetadataSlidingExpiration="HH:MM:SS"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
---|---|
idleTimeout |
Optionales TimeSpan-Attribut. Legt die Zeit im Format HH:MM:SS fest, oder "Infinite", bevor eine inaktive Anwendung entladen wird. Der Standardwert ist "Infinite". |
shadowCopyBinAssemblies |
Optionales Boolean-Attribut. Legt einen booleschen Wert fest, der angibt, ob die Assemblys einer Anwendung im Verzeichnis Bin mittels Spiegelung in das Verzeichnis für temporäre ASP.NET-Dateien der Anwendung kopiert werden. Der Standardwert ist true. |
shutdownTimeout |
Optionales TimeSpan-Attribut. Legt die Zeitdauer für das ordnungsgemäße Beenden der Anwendung in Sekunden fest. Weitere Informationen finden Sie unter ShutdownTimeout. Der Standardwert ist 30. |
urlMetadataSlidingExpiration |
Optionales TimeSpan-Attribut. Bestimmt, wie URL-Metadaten von ASP.NET zwischengespeichert werden. Das Format lautet HH:MM:SS oder "Unendlich". Die Werte "00:00:00" und "Unendlich" besitzen besondere Bedeutung. Weitere Informationen finden Sie unter UrlMetadataSlidingExpiration. Der Standardwert beträgt 1 Minute. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
---|---|
configuration |
Das erforderliche Stammelement jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an. Enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern. |
Hinweise
Standardkonfiguration
Das folgende hostingEnvironment-Standardelement wird nicht explizit in der Computerkonfigurationsdatei oder in der Stammdatei Web.config konfiguriert, sondern stellt die von einer Anwendung in .NET Framework, Version 2.0, zurückgegebene Standardkonfiguration dar.
Hinweis
Der Wert "Unendlich" wird vom System als MaxValue definiert.
<hostingEnvironment
idleTimeout="Infinite"
shutdownTimeout="30"
shadowCopyBinAssemblies="true" />
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie das Verhalten der Hostumgebung der Anwendung gesteuert wird.
<system.web>
<hostingEnvironment idleTimeout="20"
shutdownTimeout="30"/>
</system.web>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
IIS 6.0 .NET Framework 2.0 Visual Studio 2005 |
Siehe auch
Aufgaben
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
System.Web.Hosting.HostingEnvironment
Konzepte
ASP.NET Configuration File Hierarchy
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen