httpRuntime-Element (ASP.NET-Einstellungsschema)

Artikel
09/03/2008

Aktualisiert: November 2007

Konfiguriert HTTP-Laufzeiteinstellungen von ASP.NET, die bestimmen, wie eine Anforderung für eine ASP.NET-Anwendung verarbeitet wird.

configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
httpRuntime-Element (ASP.NET-Einstellungsschema)

<httpRuntime
      executionTimeout = "number" 
   maxRequestLength = "number" 
   requestLengthDiskThreshold = "number" 
   useFullyQualifiedRedirectUrl = "[True|False]" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   appRequestQueueLimit = "number"
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   apartmentThreading = "[True|False]"
   requireRootedSaveAsPath = "[True|False]"
   enable = "[True|False]" 
   sendCacheControlHeader = "[True|False]" 
      shutdownTimeout = "number"
   delayNotificationTimeout = "number"
   waitChangeNotification = "number" 
   maxWaitChangeNotification = "number" 
   enableHeaderChecking = "[True|False]" 
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
apartmentThreading	Optionales Boolean-Attribut. Aktiviert das Apartmentthreading für die Kompatibilität mit klassischem ASP. Dieses Attribut ist neu in .NET Framework, Version 2.0. Die Standardeinstellung ist False.
appRequestQueueLimit	Optionales Int32-Attribut. Gibt die maximale Anzahl der Anforderungen an, die ASP.NET in die Warteschlange für die Anwendung einfügt. Wenn nicht genügend freie Threads für die Verarbeitung einer Anforderung vorhanden sind, werden die Anforderungen in die Warteschlange eingereiht. Eingehende Anforderungen werden mit der Fehlermeldung "503 – Der Server ist ausgelastet" abgewiesen, wenn die Größe der Warteschlange den in diesem Attribut festgelegten Wert überschreitet. Der Standardwert ist 5000. Tipp Für .NET Framework, Version 1.0 und 1.1, beträgt der Standardwert 100.
delayNotificationTimeout	Optionales TimeSpan-Attribut. Gibt das Timeout für die Verzögerung von Benachrichtigungen in Sekunden an. Dieses Attribut ist neu in .NET Framework, Version 2.0. Der Standardwert beträgt 5 Sekunden.
Enable	Optionales Boolean-Attribut. Gibt an, ob die Anwendungsdomäne (AppDomain) eingehende Anforderungen auf der aktuellen Knotenebene und der untergeordneten Knotenebene akzeptiert. Im Falle von False wird die Anwendung wirksam deaktiviert. Die Standardeinstellung ist True.
enableHeaderChecking	Optionales Boolean-Attribut. Gibt an, ob ASP.NET den Anforderungsheader hinsichtlich potenzieller Injection-Angriffe überprüfen soll. Wenn ein Angriff erkannt wird, reagiert ASP.NET mit einem Fehler. Dieses Attribut ist neu in .NET Framework 2.0. Die Standardeinstellung ist True.
enableKernelOutputCache	Optionales Boolean-Attribut. Gibt an, ob die Zwischenspeicherung der Ausgabe aktiviert ist. Dieses Attribut ist nur relevant, wenn Microsoft Internetinformationsdienste (IIS) 6.0 oder höher installiert ist. Die Konfiguration der Zwischenspeicherung der Ausgabe und der Typ der Anforderung bestimmen, ob Inhalte zwischengespeichert werden können. Damit eine Antwort zwischengespeichert wird, müssen folgende Kriterien erfüllt sein: Die Zwischenspeicherung muss durch eine Seitendirektive oder mithilfe der API für das Zwischenspeichern explizit aktiviert sein. Für die Zwischenspeicherung muss eine Ablaufrichtlinie vorhanden sein, sodass der Kernel erkennt, wann er die Antwort verwerfen soll. Variable Header oder Parameter sind bei der Zwischenspeicherung nicht vorhanden. Eine Authentifizierung ist nicht erforderlich. Die Standardeinstellung ist True.
enableVersionHeader	Optionales Boolean-Attribut. Gibt an, ob ASP.NET einen Versionsheader ausgibt. Dieses Attribut wird von Microsoft Visual Studio 2005 zur Bestimmung der aktuell verwendeten Version von ASP.NET verwendet. Dieses Attribut ist für Produktionssites nicht erforderlich und kann deaktiviert werden. Tipp Dieses Attribut steht in .NET Framework 1.0 nicht zur Verfügung. Die Standardeinstellung ist True.
executionTimeout	Optionales TimeSpan-Attribut. Gibt an, wie viele Sekunden lang eine Anforderung maximal ausgeführt werden kann, bevor sie von ASP.NET automatisch beendet wird. Dieses Timeout ist nur gültig, wenn das Debugattribut im compilation-Element False ist. Falls das debug-Attribut True lautet, legen Sie für dieses Timeout keinen großen Wert fest, damit die Anwendung nicht während des Debuggens heruntergefahren wird. Der Standardwert beträgt 110 Sekunden. Tipp Für .NET Framework 1.0 und 1.1 beträgt der Standardwert90 Sekunden.
maxRequestLength	Optionales Int32-Attribut. Gibt die Grenze des Pufferungsschwellenwerts für den Eingabestream in KB an. Diese Grenze kann zum Verhindern von Denial-of-Service-Angriffen verwendet werden, die beispielsweise dadurch verursacht werden, dass Benutzer große Dateien auf dem Server bereitstellen. Der Standardwert ist 4096 KB. Wenn der Schwellenwert überschritten wird, wird ConfigurationErrorsException ausgelöst.
maxWaitChangeNotification	Optionales Int32-Attribut. Gibt die maximale Anzahl von Sekunden an, die nach der ersten Benachrichtigung über eine Dateiänderung gewartet wird, bevor AppDomain für eine neue Anforderung neu gestartet wird. Legen Sie dieses Attribut auf einen Wert fest, der größer ist als die Zeit, die für das Beenden aller Dateikopiervorgänge benötigt wird. Zusammen mit dem waitChangeNotification-Attribut bildet der Wert dieses Attributs die Grundlage für Benachrichtigungen über Dateiänderungen. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist 0.
minFreeThreads	Optionales Int32-Attribut. Gibt die Mindestanzahl freier Threads an, um die Ausführung neuer lokaler Anforderungen zu ermöglichen. Die angegebene Anzahl von Threads bleibt in ASP.NET für Anforderungen verfügbar, deren vollständige Verarbeitung zusätzliche Threads erfordert. Der Standardwert ist 8.
minLocalRequestFreeThreads	Optionales Int32-Attribut. Gibt die Mindestanzahl freier Threads an, die in ASP.NET verfügbar bleiben, um die Ausführung neuer lokaler Anforderungen zu ermöglichen. Die angegebene Anzahl von Threads bleibt für Anforderungen des lokalen Hosts reserviert für den Fall, dass einige Anforderungen während ihrer Verarbeitung untergeordnete Anforderungen an den lokalen Host ausgeben. Dadurch werden mögliche Engpässe beim rekursiven Wiedereintreten in den Webserver verhindert. Der Standardwert ist 4.
requestLengthDiskThreshold	Optionales Int32-Attribut. Gibt die Grenze des Pufferungsschwellenwerts für den Eingabestream in Kilobyte an. Der Wert sollte nicht größer als das maxRequestLength-Attribut sein. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist 80 KB.
requireRootedSaveAsPath	Optionales Boolean-Attribut. Gibt an, ob der filename-Parameter einer SaveAs-Methode ein absoluter Pfad sein muss. Der ASP.NET-Prozess muss über die Berechtigung zum Erstellen von Dateien an dem angegebenen Speicherort verfügen. Dieses Attribut ist neu in .NET Framework 2.0. Die Standardeinstellung ist True.
sendCacheControlHeader	Optionales Boolean-Attribut. Gibt an, ob ein Cachesteuerelementheader gesendet werden soll. Die Standardeinstellung ist Private. Bei True ist clientseitiges Caching deaktiviert. Dieses Attribut ist neu in .NET Framework 2.0. Die Standardeinstellung ist True.
shutdownTimeout	Optionales TimeSpan-Attribut. Gibt die Anzahl der Minuten an, die für das Beenden des Workerprozesses zur Verfügung stehen. Nach Ablauf des Timeouts beendet ASP.NET den Workerprozess. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert beträgt 90 Sekunden.
useFullyQualifiedRedirectUrl	Optionales Boolean-Attribut. Gibt an, ob clientseitige Umleitungen vollqualifiziert sind (unter Verwendung des für einige mobile Steuerelemente erforderlichen Formats "https://server/path") oder ob stattdessen relative Umleitungen an den Client gesendet werden. Bei True werden alle Umleitungen, die nicht vollqualifiziert sind, automatisch in ein vollqualifiziertes Format konvertiert. Tipp Wenn dieses Attribut auf False festgelegt ist, können bei einigen Browsern Probleme auftreten, wenn Sie Seiten in Sitzungen ohne Cookies laden. Die Standardeinstellung ist False.
waitChangeNotification	Optionales Int32-Attribut. Gibt die Zeitdauer in Sekunden an, die auf eine weitere Benachrichtigung über eine Dateiänderung abgewartet werden muss, bevor AppDomain neu gestartet wird. Legen Sie dieses Attribut auf einen Wert fest, der größer ist als die Zeit, die zwischen den Aktualisierungen zweier Änderungsbenachrichtigungen über das Kopieren von Dateien liegt. Zusammen mit dem maxWaitChangeNotification -Attribut bildet der Wert dieses Attributs die Grundlage für Benachrichtigungen über Dateiänderungen. Dieses Attribut ist neu in .NET Framework 2.0. Der Standardwert ist 0 Sekunden.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das erforderliche Stammelement in 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 und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

Hinweise

Das httpRuntime-Element konfiguriert die HTTP-Laufzeiteinstellungen von ASP.NET, die bestimmen, wie eine Anforderung einer ASP.NET-Anwendung verarbeitet wird. .NET Framework enthält eine Reihe verschiedener Laufzeithosts, darunter den ASP.NET-Laufzeithost. Beim Empfang einer Anforderung lädt ASP.NET die Laufzeiteinstellung in den Prozess, der für die Verarbeitung der Anforderung zuständig ist. ASP.NET erstellt auch eine Anwendungsdomäne für jede Webanwendung, die auf einem Webserver ausgeführt wird.

Standardkonfiguration

Das httpRuntime-Element wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config definiert. Die folgenden Einstellungen sind jedoch die Standardwerte, die vom System initialisiert werden. Wenn Sie diesen Abschnitt anpassen möchten, müssen Sie ihn in der Konfigurationsdatei erstellen und nur die Attribute definieren, die angepasst werden sollen.

<httpRuntime 
   executionTimeout="110"
   maxRequestLength="4096"
   requestLengthDiskThreshold="80"
   useFullyQualifiedRedirectUrl="false"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   appRequestQueueLimit="5000"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   requireRootedSaveAsPath="true"
   enable="true"
   shutdownTimeout="90"
   delayNotificationTimeout="5"
   waitChangeNotification="0"
   maxWaitChangeNotification="0"
   requestPriority="Normal"
   enableHeaderChecking="true"
   sendCacheControlHeader="true"
   apartmentThreading="false"
/>

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie HTTP-Laufzeitparameter für eine ASP.NET-Anwendung angegeben werden.

<configuration>
  <system.web>
  <httpRuntime maxRequestLength="4000"
    enable = "True"
    requestLengthDiskThreshold="512
    useFullyQualifiedRedirectUrl="True"
    executionTimeout="45"
    versionHeader="1.1.4128"/>
  </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	HttpRuntimeSection
Konfigurationsmember	HttpRuntime
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework 1.0, 1.1, 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Freigeben über

httpRuntime-Element (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen