<requestCaching>-Element (Netzwerkeinstellungen)

Artikel
06/12/2023

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>