RequestCachingSection クラス
要求キャッシュの構成情報を含みます。
構文
class RequestCachingSection : ConfigurationSection
メソッド
次の表に、RequestCachingSection クラスによって公開されるメソッドの一覧を示します。
| 名前 | 説明 |
|---|---|
| GetAllowDefinition | (ConfigurationSection から継承。) |
| GetAllowLocation | (ConfigurationSection から継承。) |
| RevertToParent | (ConfigurationSection から継承。) |
| SetAllowDefinition | (ConfigurationSection から継承。) |
| SetAllowLocation | (ConfigurationSection から継承。) |
プロパティ
次の表は、RequestCachingSection クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
DefaultFtpCachePolicy |
ローカル コンピューターの既定の FTP キャッシュ動作を指定する FtpCachePolicySettings 値。 |
DefaultHttpCachePolicy |
ローカル コンピューターの既定の HTTP キャッシュ動作を指定する HttpCachePolicySettings 値。 |
DefaultPolicyLevel |
既定のキャッシュ ポリシー レベルを指定する、読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
DisableAllCaching |
読み取り/書き込みの boolean 値。 ローカル コンピューターでキャッシュを無効にする場合は true。それ以外の場合は false。 注: この構成属性が任意の構成ファイルで true に設定されている場合、キャッシュはグローバルに無効になり、その他のキャッシュ関連の設定はすべて無視されます。 |
IsPrivateCache |
読み取り/書き込みの boolean 値。 ローカル コンピューターのキャッシュをプライベートにする (つまり、ユーザーの分離を提供する) 場合は true。それ以外の場合は false。 注: クライアント コンピューターでは、この値は通常 true に設定されます。これは、ユーザーが別のユーザーによってキャッシュされたリソースを使用できないことを示します。 中間層アプリケーションの場合、この値は通常 false に設定されます。 |
Location |
(ConfigurationSection から継承。)キー プロパティ。 |
Path |
(ConfigurationSection から継承。)キー プロパティ。 |
SectionInformation |
(ConfigurationSection から継承。) |
UnspecifiedMaximumAge |
有効期限情報がないキャッシュされたリソースの既定の最大有効期間を指定する、読み取り/書き込みの datetime 値。 既定値は 1 日です。 このプロパティを設定すると、有効期限のヘッダー情報を持たないリソースがいつまでもキャッシュ内に残らないようにすることができます。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
次の表に、DefaultPolicyLevel プロパティとして使用できる値の一覧を示します。 既定値は 1 (BypassCache) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | Default |
キャッシュされたリソースのコピーを使用するか、リソースの要求をサーバーに送信して、リソースの要求に応じます。 実行される動作は、現在のキャッシュ ポリシーとキャッシュ内のコンテンツの世代によって決まります。 ほとんどのアプリケーションではこのキャッシュ レベルを使用すべきです。 |
| 1 | BypassCache |
サーバーを使用して要求に応じます。 クライアントとサーバー間では、エントリはキャッシュから取得したり、キャッシュに追加、またはキャッシュから削除したりされません。 これは、.NET Framework に含まれるコンピューターの構成ファイルで指定されている既定のキャッシュ動作です。 |
| 2 | CacheOnly |
ローカルにキャッシュされたリソースを使用して要求に応じ、キャッシュにないアイテムの要求は送信しません。 このキャッシュ ポリシー レベルが指定されている場合、アイテムがクライアントのキャッシュになければ WebException 例外がスローされます。 |
| 3 | CacheIfAvailable |
リソースが利用可能な場合は、キャッシュからリソースの要求に応じます。それ以外の場合は、リソースの要求をサーバーに送信します。 要求されたアイテムがローカル キャッシュにないが、クライアントとサーバー間のキャッシュにある場合は、その中間キャッシュによって要求が満たされます。 |
| 4 | Revalidate |
タイム スタンプがサーバー上のリソースのタイム スタンプと同じである場合は、そのリソースのキャッシュ コピーを使って要求に応じます。そうでない場合は、リソースをサーバーからダウンロードし、呼び出し元に提供し、キャッシュに格納します。 |
| 5 | Reload |
サーバーを使用して要求に応じます。 HTTP キャッシュ プロトコルの no-cache キャッシュ制御ディレクティブと Pragma: no-cache ヘッダーによっては、応答がキャッシュに保存される場合があります。 |
| 6 | NoCacheNoStore |
キャッシュのリソースを使用して要求に応じることはなく、リソースをキャッシュしません。 リソースがローカル キャッシュに存在する場合は、削除されます。 このポリシー レベルは、中間キャッシュに、リソースをキャッシュから削除する必要があることを示します。 HTTP キャッシュ プロトコルでは、これは no-cache キャッシュ制御ディレクティブを使用して実現されます。 |
継承階層
RequestCachingSection
要件
| 型 | 説明 |
|---|---|
| クライアント | - Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0 |
| [サーバー] | - Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0 |
| Product | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF ファイル | WebAdministration.mof |
参照
ConfigurationSection クラス
FtpCachePolicySettings クラス
HttpCachePolicySettings クラス
System.Net.Cache.RequestCacheLevel 列挙型
System.Net.WebException クラス
CIM_DATETIME