Freigeben über


HttpRuntimeSection-Klasse

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

Syntax

class HttpRuntimeSection : ConfigurationSection  

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der HttpRuntimeSectionKlasse verfügbar gemacht werden.

Name Beschreibung
GetAllowDefinition (Geerbt von ConfigurationSection.)
GetAllowLocation (Geerbt von ConfigurationSection.)
RevertToParent (Geerbt von ConfigurationSection.)
SetAllowDefinition (Geerbt von ConfigurationSection.)
SetAllowLocation (Geerbt von ConfigurationSection.)

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der HttpRuntimeSectionKlasse verfügbar gemacht werden.

Name Beschreibung
ApartmentThreading Optionaler Lese-/Schreibboolean-Wert . true wenn Apartmentthreading für die klassische ASP-Kompatibilität aktiviert ist; andernfalls, false Der Standardwert ist false. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
AppRequestQueueLimit Ein optionaler Lese-/Schreibsint32-Wert, der die maximale Anzahl von Anforderungen angibt, die ASP.NET Warteschlangen für die Anwendung. Der Standard ist 5.000. Hinweis: Für die .NET Framework-Versionen 1.0 und 1.1 ist der Standardwert 100.

Wenn nicht genügend freie Threads zum Verarbeiten einer Anforderung vorhanden sind, werden die Anforderungen in die Warteschlange gestellt. Wenn die Anzahl der Anforderungen in der Warteschlange den Grenzwert überschreitet, der in dieser Eigenschaft angegeben ist, werden eingehende Anforderungen mit dem Fehler "503 – Server zu beschäftigt" abgelehnt.
DelayNotificationTimeout Ein optionaler Lese-/Schreibwert datetime, der das Timeout für verzögerte Benachrichtigungen angibt. Der Standardwert lautet 5 Sekunden. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
Enable Optionaler Lese-/Schreibboolean-Wert . true wenn die Anwendungsdomäne (AppDomain) aktiviert ist, um eingehende Anforderungen auf der aktuellen und untergeordneten Knotenebene zu akzeptieren; andernfalls, false. Der Standardwert ist true. Wenn falsedie Anwendung effektiv deaktiviert ist.
EnableHeaderChecking Optionaler Lese-/Schreibboolean-Wert . true wenn ASP.NET den Anforderungsheader auf potenzielle Einfügungsangriffe überprüfen sollte; andernfalls, false. Der Standardwert ist true. Wenn ein Angriff erkannt wird, reagiert ASP.NET mit einem Fehler. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
EnableKernelOutputCache Optionaler Lese-/Schreibboolean-Wert . true, wenn die Ausgabezwischenspeicherung aktiviert ist, andernfalls false. Der Standardwert ist true.

Dieses Attribut ist nur relevant, wenn IIS 6.0 oder 7.0 installiert ist. Die Konfiguration der Ausgabezwischenspeicherung und der Anforderungstyp bestimmt, ob Inhalte zwischengespeichert werden können.

Um eine Antwort zwischenzuspeichern, müssen Sie sicherstellen, dass die folgenden Kriterien erfüllt sind:

– Die Zwischenspeicherung muss explizit durch eine Seitendirektive oder mithilfe der Cache-API aktiviert werden.
– Zwischenspeichern muss über eine Ablaufrichtlinie verfügen, damit der Kernel erkennt, wann die Antwort verworfen werden soll.
- Zwischenspeichern hat keine Variablenheader oder Parameter.
- Eine Authentifizierung ist nicht erforderlich.
EnableVersionHeader Optionaler Lese-/Schreibboolean-Wert . true wenn ASP.NET einen Versionsheader ausgeben soll; andernfalls, false Der Standardwert ist true.

Visual Studio 2005 verwendet diese Eigenschaft, um zu bestimmen, welche Version von ASP.NET verwendet wird. Diese Eigenschaft ist für Produktionswebsites nicht erforderlich und kann deaktiviert werden.
ExecutionTimeout Ein optionaler Lese-/Schreibdatetime-Wert , der die maximale Ausführungszeit einer Anforderung angibt, bevor ASP.NET sie automatisch beendet. Der Standardwert ist 1 Minute, 50 Sekunden.

Dieses Timeout gilt nur, wenn die Debug Eigenschaft in der CompilationSection-Klasse ist false. Um das Herunterfahren der Anwendung beim Debuggen zu vermeiden, legen Sie dieses Timeout nicht auf einen großen Wert fest.
Location (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
MaxRequestLength Ein optionaler Lese-/Schreibsint32-Wert, der den Grenzwert in Kilobyte für den Schwellenwert für die Pufferung des Eingabedatenstroms angibt. Der Standardwert ist 4096 (4 MB).

Sie können diesen Grenzwert verwenden, um Denial-of-Service-Angriffe zu verhindern, die z. B. durch Benutzer verursacht werden, die große Dateien auf dem Server veröffentlichen.
MaxWaitChangeNotification Ein optionaler Lese-/Schreibsint32-Wert , der die maximale Zeit in Sekunden angibt, um nach der ersten Dateiänderungsbenachrichtigung zu warten, bevor die Anwendungsdomäne für eine neue Anforderung neu gestartet wird. Der Standardwert ist 0.

Legen Sie diese Eigenschaft auf eine Zahl fest, die größer als die Zeit ist, um alle Dateikopieprozesse abzuschließen. Dateiänderungsbenachrichtigungen werden basierend auf dem Wert dieser Eigenschaft und der WaitChangeNotification Eigenschaft kombiniert. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
MinFreeThreads Ein optionaler Lese-/Schreibsint32-Wert, der die Mindestanzahl von Threads angibt, die für Anforderungen verfügbar ASP.NET, die zusätzliche Threads zum Abschließen der Verarbeitung benötigen. Der Standard ist 8.
MinLocalRequestFreeThreads Ein optionaler Lese-/Schreibsint32-Wert, der die Mindestanzahl von Threads angibt, die für lokale Anforderungen verfügbar ASP.NET, die zusätzliche Threads zum Abschließen der Verarbeitung benötigen. Der Standardwert ist 4. Hinweis: Die angegebene Anzahl von Threads ist für Anforderungen reserviert, die vom lokalen Host stammen, falls einige dieser Anforderungen untergeordnete Anforderungen während der Verarbeitung ausstellen. Dadurch wird verhindert, dass ein möglicher Deadlock mit rekursivem Wiederholungsversuche auf dem Webserver.
Path (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
RequestLengthDiskThreshold Ein optionaler Lese-/Schreibsint32-Wert, der in Byte den Grenzwert für den Schwellenwert für die Pufferung des Eingabedatenstroms angibt. Der Standardwert ist 256.

Dieser Wert sollte den Wert in der MaxRequestLength Eigenschaft nicht überschreiten. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
RequireRootedSaveAsPath Optionaler Lese-/Schreibboolean-Wert . true wenn der filename Parameter in einer SaveAs Methode ein absoluter Pfad sein muss; andernfalls false. Der Standardwert ist true.

Der ASP.NET Prozess muss über die Berechtigung zum Erstellen von Dateien am angegebenen Speicherort verfügen. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
SectionInformation (Geerbt von ConfigurationSection.)
SendCacheControlHeader Optionaler Lese-/Schreibboolean-Wert . true wenn ein Cachesteuerelementheader, der auf "Privat" festgelegt ist, standardmäßig gesendet wird; andernfalls, false. Wenn truedie clientseitige Zwischenspeicherung deaktiviert ist. Der Standardwert ist true. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
ShutdownTimeout Ein optionaler Lese-/Schreibdatetime-Wert, der die Zeit angibt, die für das Herunterfahren eines Arbeitsprozesses zulässig ist. Der Standardwert ist 1 Minute, 30 Sekunden.

Wenn der Timeout abläuft, wird ASP.NET den Arbeitsprozess herunterfahren. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.
UseFullyQualifiedRedirectUrl Optionaler Lese-/Schreibboolean-Wert . true, wenn clientseitige Umleitungen vollqualifiziert sind, andernfalls false. Der Standardwert ist false.

Verwenden Sie das Format http://server/path, um clientseitige Umleitungen vollständig zu qualifizieren. Dieses Format ist für einige mobile Steuerelemente erforderlich. Wenn true, alle Umleitungen, die nicht vollqualifizierte sind, automatisch in ein vollqualifiziertes Format konvertiert werden. Wenn false, relative Umleitungen werden an den Client gesendet. Hinweis: Wenn falsebei einigen Browsern Probleme auftreten können, wenn Seiten geladen werden, die sich in cookielosen Sitzungen befinden.
WaitChangeNotification Ein optionaler Lese-/Schreibsint32-Wert, der die Zeit in Sekunden angibt, bis eine andere Dateiänderungsbenachrichtigung vor dem Neustart der Anwendungsdomäne ausgeführt wird. Der Standardwert ist 0.

Legen Sie dieses Attribut auf eine Zahl fest, die größer als die Zeit zwischen den Aktualisierungen von zwei Änderungsbenachrichtigungen für Dateikopien ist. Dateiänderungsbenachrichtigungen werden basierend auf dem Wert dieser Eigenschaft und der MaxWaitChangeNotification Eigenschaft kombiniert. Hinweis: Diese Eigenschaft ist neu in der .NET Framework Version 2.0.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Vererbungshierarchie

ConfigurationSection

HttpRuntimeSection

Anforderungen

type Beschreibung
Client IIS 7.0 unter Windows Vista.
IIS 7.5 unter Windows 7
IIS 8.0 unter Windows 8
IIS 10.0 unter Windows 10
Server IIS 7.0 unter Windows Server 2008
- IIS 7.5 unter Windows Server 2008 R2
IIS 8.0 auf Windows Server 2012.
- IIS 8.5 unter Windows Server 2012 R2
IIS 10.0 auf Windows Server 2016.
Produkt - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei WebAdministration.mof

Weitere Informationen

System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
ConfigurationSection-Klasse
CompilationSection-Klasse
CIM_DATETIME