Freigeben über


<requestCaching>-Element (Netzwerkeinstellungen)

Steuert den Zwischenspeicherungsmechanismus für Netzwerkanforderungen.

<configuration>
  <system.net>
    <requestCaching>

Syntax

<requestCaching  
  isPrivateCache ="true|false"  
  disableAllCaching="true|false"  
  defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"  
  unspecifiedMaximumAge= "d.hh:mm:ss">  
    <defaultHttpCachePolicy>...</defaultHttpCachePolicy>  
    <defaultFtpCachePolicy>...</defaultFtpCachePolicy>  
</requestCaching>

Attribute und Elemente

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

Attribute

attribute Beschreibung
isPrivateCache Gibt an, ob der Cache eine Isolation zwischen den Informationen verschiedener Benutzer*innen bietet. Der Standardwert ist true. Dieser Wert sollte für Anwendungen der mittleren Ebene false sein.
disableAllCaching Gibt an, dass die Zwischenspeicherung für alle Webantworten deaktiviert ist und dies nicht programmgesteuert außer Kraft gesetzt werden kann.
defaultPolicyLevel Einer der Werte in der RequestCacheLevel-Enumeration. Der Standardwert ist BypassCache.
unspecifiedMaximumAge Gibt die Standardzeit an, nach der Inhalte als abgelaufen markiert werden.

policyLevel-Attribut

Wert Beschreibung
Default Gibt die zwischengespeicherte Ressource zurück, wenn die Ressource neu ist, die Inhaltslänge korrekt ist und die Attribute für Ablauf, Änderung und Inhaltslänge vorhanden sind.
BypassCache Gibt die Ressource vom Server zurück.
CacheOnly Gibt die zwischengespeicherte Ressource zurück, wenn die Inhaltslänge vorhanden ist und der Eintragsgröße entspricht.
CacheIfAvailable Gibt die zwischengespeicherte Ressource zurück, wenn die Inhaltslänge bereitgestellt ist und der Eintragsgröße entspricht. Andernfalls wird die Ressource vom Server heruntergeladen und an den Aufrufer zurückgegeben.
Revalidate Gibt die zwischengespeicherte Ressource zurück, wenn der Zeitstempel der zwischengespeicherten Ressource dem Zeitstempel der Ressource auf dem Server entspricht. Andernfalls wird die Ressource vom Server heruntergeladen, im Cache gespeichert und an den Aufrufer zurückgegeben.
Reload Lädt die Ressource vom Server herunter, speichert sie im Cache und gibt die Ressource an den Aufrufer zurück.
NoCacheNoStore Ist bereits eine zwischengespeicherte Ressource vorhanden, wird sie gelöscht. Die Ressource wird vom Server heruntergeladen und an den Aufrufer zurückgegeben.
Revalidate Erfüllt eine Anforderung, indem die zwischengespeicherte Kopie der Ressource zurückgegeben wird, wenn der Zeitstempel der zwischengespeicherten Ressource dem Zeitstempel der Ressource auf dem Server entspricht. Andernfalls wird die Ressource vom Server heruntergeladen, dem Aufrufer präsentiert und im Cache gespeichert.

Untergeordnete Elemente

Element Beschreibung
defaultHttpCachePolicy Optionales Element.

Beschreibt, ob die HTTP-Zwischenspeicherung aktiv ist, und beschreibt die Standardzwischenspeicherungsrichtlinie.
<defaultFtpCachePolicy>-Element (Netzwerkeinstellungen) Optionales Element.

Beschreibt, ob die FTP-Zwischenspeicherung aktiv ist, und beschreibt die Standardzwischenspeicherungsrichtlinie.

Übergeordnete Elemente

Element BESCHREIBUNG
system.net Enthält Einstellungen, die festlegen, wie Verbindungen zwischen .NET Framework und dem Netzwerk hergestellt werden.

Beispiel

Das folgende Beispiel zeigt die Deaktivierung der gesamten Zwischenspeicherung:

<configuration>  
  <system.net>  
    <requestCaching  
      disableAllCaching="true"  
    />  
  </system.net>  
</configuration>  

Siehe auch