<requestCaching> 要素 (ネットワーク設定)

  • [アーティクル]

ネットワーク要求のキャッシュ メカニズムを制御します。

configuration
  <system.net>
    <requestCaching>

構文

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
isPrivateCache さまざまなユーザーの情報がキャッシュで分離されるかどうかを指定します。 既定値は true です。 中間層のアプリケーションの場合、この値は false にする必要があります。
disableAllCaching キャッシュはすべての Web 応答に対して無効であり、プログラミングでオーバーライドできないことを指定します。
defaultPolicyLevel RequestCacheLevel 列挙値の値の 1 つ。 既定値は BypassCache です。
unspecifiedMaximumAge コンテンツに期限切れのマークを付けるタイミングの既定値を指定します。

policyLevel 属性

[値] 説明
Default リソースが最新で、コンテンツの長さが正確で、有効期限、変更、およびコンテンツの長さの属性が存在する場合、キャッシュされたリソースを返します。
BypassCache サーバーからリソースを返します。
CacheOnly コンテンツの長さが存在し、エントリのサイズと一致する場合、キャッシュされたリソースを返します。
CacheIfAvailable コンテンツの長さが指定され、エントリのサイズと一致する場合に、キャッシュされたリソースを返します。それ以外の場合は、リソースがサーバーからダウンロードされ、呼び出し元に返されます。
Revalidate キャッシュされたリソースのタイムスタンプがサーバーのリソースのタイムスタンプと同じ場合は、キャッシュされたリソースを返します。それ以外の場合は、リソースがサーバーからダウンロードされ、キャッシュに格納され、呼び出し元に返されます。
Reload サーバーからリソースをダウンロードし、キャッシュに格納して、リソースを呼び出し元に返します。
NoCacheNoStore キャッシュされたリソースが存在する場合は、削除されます。 リソースはサーバーからダウンロードされ、呼び出し元に返されます。
Revalidate タイムスタンプがサーバーのリソースのタイムスタンプと同じ場合は、キャッシュされたリソースのコピーを使用して要求に応じます。それ以外の場合は、リソースがサーバーからダウンロードされ、呼び出し元に提示され、キャッシュに格納されます。

子要素

要素 説明
defaultHttpCachePolicy 省略可能な要素です。

HTTP キャッシュがアクティブかどうか、および既定のキャッシュ ポリシーを示します。
<defaultFtpCachePolicy> 要素 (ネットワーク設定) 省略可能な要素です。

FTP キャッシュがアクティブかどうか、および既定のキャッシュ ポリシーを示します。

親要素

要素 説明
system.net .NET Framework がネットワークに接続する方法を指定するための設定が含まれています。

例

次の例は、すべてのキャッシュを無効にする方法を示しています。

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

関連項目