hostingEnvironment-Element (ASP.NET-Einstellungsschema)

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, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute

Beschreibungen

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

Beschreibungen

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

HinweisHinweis

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

System.Web.Configuration.HostingEnvironmentSection

Konfigurationsmember

SystemWebSectionGroup.HostingEnvironment

Konfigurierbare Verzeichnisse

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

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

System.Web.Hosting.HostingEnvironment

System.Configuration

System.Web.Configuration

Konzepte

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Websiteverwaltung

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurations-API