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

関連項目

• System.Net.Cache
• ネットワーク設定スキーマ