Freigeben über


<httpRuntime>-Element

Konfiguriert ASP.NET-HTTP-Laufzeiteinstellungen. Dieser Abschnitt kann auf Computer-, Site-, Anwendungs- oder Unterverzeichnisebene deklariert werden.

<configuration>
   <system.web>
      <httpRuntime>

<httpRuntime useFullyQualifiedRedirectUrl="true|false"             maxRequestLength="size in kbytes"             executionTimeout="seconds"             minFreeThreads="number of threads"             minFreeLocalRequestFreeThreads="number of threads"             appRequestQueueLimit="number of requests"             versionHeader="version string"/>

Optionale Attribute

Attribut Option Beschreibung
appRequestQueueLimit     Die maximale Anzahl der Anforderungen, 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 dieser Einstellung festgelegten Wert überschreitet.
executionTimeout     Gibt an, wie viele Sekunden lang eine Anforderung maximal ausgeführt werden kann, bevor sie von ASP.NET automatisch beendet wird.
enable Gibt an, ob die Anwendungsdomäne auf dem aktuellen und auf dem untergeordneten Knoten aktiviert ist. Der Standardwert ist true.
    true Gibt an, dass die Anwendungsdomäne aktiviert werden soll.
    false Gibt an, dass die Anwendungsdomäne deaktiviert werden soll. Die Anwendung wird nicht in den Speicher geladen, und jede Clientanforderung verursacht die Ausgabe eines 404-Fehlers.
idleTimeout     Gibt die Leerlaufzeit der Anwendungsdomäne an, bevor diese beendet wird. Der Standardwert ist 20 Minuten.
enableKernelModeCache   Gibt an, ob die Zwischenspeicherung der Ausgabe aktiviert ist. Derzeit ist dieses Attribut nur relevant, wenn IIS, Version 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.

Für das Zwischenspeichern einer Antwort müssen die folgenden Kriterien erfüllt sein:

  • Die Zwischenspeicherung muss durch eine Seitendirektive oder durch Verwendung der API für das Zwischenspeichern explizit aktiviert sein.
  • Für die Zwischenspeicherung muss eine Ablaufrichtlinie vorhanden sein, so dass der Kernel weiß, wann er sie verwerfen soll.
  • Variable Kopfzeilen oder Parameter sind für die Zwischenspeicherung nicht zulässig.
  • Die Anforderung darf keine Authentifizierung erfordern.
  true Gibt an, dass die Zwischenspeicherung aktiviert werden soll.
  false Gibt an, dass die Zwischenspeicherung deaktiviert werden soll.
maxRequestLength     Gibt die maximale Größe der Dateien an, die von ASP.NET geuploadet werden können. Mit Hilfe dieser Einschränkung können DOS-Attacken (Denial of Service, DOS) verhindert werden, die durch das Senden umfangreicher Dateien an den Server verursacht werden. Die Größe wird in Kilobyte angegeben. Der Standardwert ist 4096 KB (4 MB).
minFreeLocalRequestFreeThreads     Die Mindestanzahl freier Threads, die in ASP.NET verfügbar bleiben, um die Ausführung neuer lokaler Anforderungen zu ermöglichen. Diese Anzahl von Threads bleibt für Anforderungen vom lokalen Host für den Fall reserviert, dass einige Anforderungen während der Verarbeitung untergeordnete Anforderungen an den lokalen Host ausgeben. Dadurch werden mögliche Engpässe beim rekursiven Wiedereintreten in den Webserver verhindert.
minFreeThreads     Die Mindestanzahl freier Threads, um die Ausführung neuer lokaler Anforderungen zu ermöglichen. Diese Anzahl von Threads bleibt in ASP.NET für Anforderungen verfügbar, deren vollständige Verarbeitung zusätzliche Threads erfordert.
useFullyQualifiedRedirectUrl     Gibt an, ob clientseitige Umleitungen voll gekennzeichnet sind (in der Form {HYPERLINK "https://Server/Pfad"}, was für einige mobile Steuerelemente erforderlich ist) oder stattdessen relative Umleitungen an den Client gesendet werden.
    true Gibt an, dass clientseitige Umleitungen voll gekennzeichnet sein müssen. Dies wird erreicht, indem automatisch alle nicht voll gekennzeichneten Umleitungen in voll gekennzeichnete Umleitungen konvertiert werden.
    false Gibt an, dass clientseitige Umleitungen nicht automatisch in die voll gekennzeichnete Form konvertiert werden müssen. Der Standardwert lautet false.
versionHeader     Gibt den Wert eines Versionsheaders an, den ASP.NET mit jeder Antwort sendet. Anhand dieses Attributs stellt Microsoft Visual Studio .NET fest, welche ASP.NET-Version verwendet wird. Für Produktionssites ist dieses Attribut nicht unbedingt erforderlich. Es lässt sich deaktivieren, indem es aus Web.config oder Machine.config gelöscht wird oder indem es auf eine leere Zeichenfolge festgelegt wird (versionHeader="").

Beispiel

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

<configuration>
   <system.web>
      <httpRuntime maxRequestLength="4000"
         useFullyQualifiedRedirectUrl="true"
         executionTimeout="45"
         versionHeader="1.1.4128"/>
   </system.web>
</configuration>

Anforderungen

Enthalten in: <system.web>

Webplattform: IIS 5.0, IIS 5.1, IIS 6.0

Konfigurationsdatei: Machine.config, Web.config

Konfigurationsabschnittshandler: System.Web.Configuration.HttpRuntimeConfigurationHandler

Siehe auch

ASP.NET-Konfiguration | ASP.NET-Einstellungsschema | Zwischenspeichern von ASP.NET-Seiten