<requestCaching> , element (ustawienia sieci)

  • Artykuł

Steruje mechanizmem buforowania żądań sieciowych.

<Konfiguracji>
  <system.net>
    <requestCaching>

Składnia

<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>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut Opis
isPrivateCache Określa, czy pamięć podręczna zapewnia izolację między informacjami o różnych użytkownikach. Wartość domyślna to true. Ta wartość powinna być false przeznaczona dla aplikacji warstwy środkowej.
disableAllCaching Określa, że buforowanie jest wyłączone dla wszystkich odpowiedzi sieci Web i nie może być zastępowane programowo.
defaultPolicyLevel Jedna z wartości w wyliczeń RequestCacheLevel . Wartość domyślna to BypassCache.
unspecifiedMaximumAge Określa domyślny czas, po którym zawartość jest oznaczona jako wygasła.

policyLevel, atrybut

Wartość Opis
Default Zwraca buforowany zasób, jeśli zasób jest świeży, długość zawartości jest dokładna, a atrybuty wygasania, modyfikacji i długości zawartości są obecne.
BypassCache Zwraca zasób z serwera.
CacheOnly Zwraca buforowany zasób, jeśli długość zawartości jest obecna i odpowiada rozmiarowi wpisu.
CacheIfAvailable Zwraca buforowany zasób, jeśli jest podana długość zawartości i pasuje do rozmiaru wpisu; w przeciwnym razie zasób jest pobierany z serwera i jest zwracany do obiektu wywołującego.
Revalidate Zwraca buforowany zasób, jeśli sygnatura czasowa buforowanego zasobu jest taka sama jak sygnatura czasowa zasobu na serwerze; w przeciwnym razie zasób jest pobierany z serwera, przechowywany w pamięci podręcznej i zwracany do obiektu wywołującego.
Reload Pobiera zasób z serwera, przechowuje go w pamięci podręcznej i zwraca zasób do obiektu wywołującego.
NoCacheNoStore Jeśli istnieje zasób buforowany, zostanie usunięty. Zasób jest pobierany z serwera i jest zwracany do obiektu wywołującego.
Revalidate Spełnia żądanie przy użyciu buforowanej kopii zasobu, jeśli sygnatura czasowa jest taka sama jak sygnatura czasowa zasobu na serwerze; w przeciwnym razie zasób jest pobierany z serwera, prezentowany obiekt wywołujący i przechowywany w pamięci podręcznej,

Elementy podrzędne

Element Opis
defaultHttpCachePolicy Element opcjonalny.

Opisuje, czy buforowanie HTTP jest aktywne i opisuje domyślne zasady buforowania.
<defaultFtpCachePolicy> , element (ustawienia sieci) Element opcjonalny.

Opisuje, czy buforowanie FTP jest aktywne i opisuje domyślne zasady buforowania.

Elementy nadrzędne

Element Opis
system.net Zawiera ustawienia określające sposób łączenia .NET Framework z siecią.

Przykład

W poniższym przykładzie pokazano, jak wyłączyć wszystkie buforowanie.

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

Zobacz też