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

ネットワーク要求のキャッシュメカニズムを制御します。Controls the caching mechanism for network requests.

<configuration><configuration>
<system.net><system.net>
<requestCaching><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>

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
isPrivateCache キャッシュがさまざまなユーザーの情報の分離を提供するかどうかを指定します。Specifies whether the cache provides isolation between the information of different users. 既定値は true です。The default value is true. 中間層アプリケーションのfalse場合は、この値をにする必要があります。This value should be false for middle tier applications.
disableAllCaching すべての Web 応答に対してキャッシュを無効にし、プログラムでオーバーライドすることはできないことを指定します。Specifies that caching is disabled for all Web responses, and cannot be overridden programmatically.
defaultPolicyLevel RequestCacheLevel 列挙値の値の 1 つ。One of the values in the RequestCacheLevel enumeration. 既定値は BypassCache です。The default value is BypassCache.
unspecifiedMaximumAge コンテンツが期限切れとしてマークされるまでの既定の時間を指定します。Specifies the default time after which content is marked as expired.

policyLevel 属性policyLevel Attribute

Value 説明Description
Default リソースが最新で、コンテンツの長さが正確で、有効期限、変更、およびコンテンツの長さの属性が存在する場合、キャッシュされたリソースを返します。Returns the cached resource if the resource is fresh, the content length is accurate, and the expiration, modification, and content length attributes are present.
BypassCache サーバーからリソースを返します。Returns the resource from the server.
CacheOnly コンテンツの長さが存在し、エントリのサイズと一致する場合、キャッシュされたリソースを返します。Returns the cached resource if the content length is present and matches the entry size.
CacheIfAvailable コンテンツの長さが指定され、エントリのサイズと一致する場合に、キャッシュされたリソースを返します。それ以外の場合は、リソースがサーバーからダウンロードされ、呼び出し元に返されます。Returns the cached resource if the content length is provided and matches the entry size; otherwise, the resource is downloaded from the server and is returned to the caller.
Revalidate キャッシュされたリソースのタイムスタンプがサーバー上のリソースのタイムスタンプと同じ場合は、キャッシュされたリソースを返します。それ以外の場合は、リソースがサーバーからダウンロードされ、キャッシュに格納されて、呼び出し元に返されます。Returns the cached resource if the timestamp of the cached resource is the same as the timestamp of the resource on the server; otherwise, the resource is downloaded from the server, stored in the cache, and is returned to the caller.
Reload サーバーからリソースをダウンロードし、キャッシュに格納して、リソースを呼び出し元に返します。Downloads the resource from the server, stores it in the cache, and returns the resource to the caller.
NoCacheNoStore キャッシュされたリソースが存在する場合は、削除されます。If a cached resource exists, it is deleted. リソースはサーバーからダウンロードされ、呼び出し元に返されます。The resource is downloaded from the server and is returned to the caller.
Revalidate タイムスタンプがサーバー上のリソースのタイムスタンプと同じ場合は、リソースのキャッシュされたコピーを使用して要求を満たします。それ以外の場合、リソースはサーバーからダウンロードされ、呼び出し元に渡され、キャッシュに格納されます。Satisfies a request by using the cached copy of the resource if the timestamp is the same as the timestamp of the resource on the server; otherwise, the resource is downloaded from the server, presented to the caller, and is stored in the cache,

子要素Child Elements

要素Element 説明Description
defaultHttpCachePolicydefaultHttpCachePolicy 省略可能な要素です。Optional element.

HTTP キャッシュがアクティブかどうか、および既定のキャッシュポリシーについて説明します。Describes whether HTTP caching is active and describes the default caching policy.
<defaultFtpCachePolicy> 要素 (ネットワーク設定<defaultFtpCachePolicy> Element (Network Settings) 省略可能な要素です。Optional element.

FTP キャッシュがアクティブでかどうかし、既定のキャッシュ ポリシーを記述について説明します。Describes whether FTP caching is active and describes the default caching policy.

親要素Parent Elements

要素Element 説明Description
system.netsystem.net .NET Framework がネットワークに接続する方法を指定するための設定が含まれています。Contains settings that specify how the .NET Framework connects to the network.

Example

次の例では、すべてのキャッシュを無効にする方法を示します。The following example shows how to disable all caching.

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

関連項目See also