HttpRequestCachePolicyとは? わかりやすく解説

HttpRequestCachePolicy クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

HttpWebRequest オブジェクトを使用して取得されるリソースに対するアプリケーションのキャッシュ要件を定義します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Public Class HttpRequestCachePolicy
    Inherits RequestCachePolicy
Dim instance As HttpRequestCachePolicy
public class HttpRequestCachePolicy : RequestCachePolicy
public ref class HttpRequestCachePolicy : public
 RequestCachePolicy
public class HttpRequestCachePolicy extends
 RequestCachePolicy
public class HttpRequestCachePolicy extends
 RequestCachePolicy
解説解説
使用例使用例

アプリケーション ドメインの既定のキャッシュ ポリシーを作成し、ある要求について、そのポリシーをオーバーライドするコード例を次に示します。

// The following method demonstrates overriding the
// caching policy for a request.
public static WebResponse GetResponseNoCache(Uri
 uri)
{
    // Set a default policy level for the "http:" and "https"
 schemes.
    HttpRequestCachePolicy policy = new HttpRequestCachePolicy(HttpRequestCacheLevel.Default);
    HttpWebRequest.DefaultCachePolicy = policy;
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    // Define a cache policy for this request only. 
    HttpRequestCachePolicy noCachePolicy = new HttpRequestCachePolicy(HttpRequestCacheLevel.NoCacheNoStore);
    request.CachePolicy = noCachePolicy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("IsFromCache? {0}", response.IsFromCache);      
      
    return response;
}
継承階層継承階層
System.Object
   System.Net.Cache.RequestCachePolicy
    System.Net.Cache.HttpRequestCachePolicy
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

HttpRequestCachePolicy コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Dim instance As New HttpRequestCachePolicy
public HttpRequestCachePolicy ()
public:
HttpRequestCachePolicy ()
public HttpRequestCachePolicy ()
public function HttpRequestCachePolicy ()
解説解説
使用例使用例

このコンストラクタを使用してキャッシュ ポリシーを設定するコード例を次に示します。

public static WebResponse GetResponseUsingCacheDefault(Uri
 uri)
{
    // Set  the default cache policy level for the "http:"
 scheme.
    RequestCachePolicy policy = new RequestCachePolicy();
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    request.CachePolicy = policy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("Policy level is {0}.", policy.Level.ToString());
    Console.WriteLine("Is the response from the cache? {0}", response.IsFromCache);
  
    
    return response;
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy コンストラクタ (HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

有効期限、保存期間の制御値、日時の値、およびキャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Public Sub New ( _
    cacheAgeControl As HttpCacheAgeControl, _
    maxAge As TimeSpan, _
    freshOrStale As TimeSpan, _
    cacheSyncDate As DateTime _
)
Dim cacheAgeControl As HttpCacheAgeControl
Dim maxAge As TimeSpan
Dim freshOrStale As TimeSpan
Dim cacheSyncDate As DateTime

Dim instance As New HttpRequestCachePolicy(cacheAgeControl,
 maxAge, freshOrStale, cacheSyncDate)
public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl,
    TimeSpan maxAge,
    TimeSpan freshOrStale,
    DateTime cacheSyncDate
)
public:
HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale, 
    DateTime cacheSyncDate
)
public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale, 
    DateTime cacheSyncDate
)
public function HttpRequestCachePolicy (
    cacheAgeControl : HttpCacheAgeControl, 
    maxAge : TimeSpan, 
    freshOrStale : TimeSpan, 
    cacheSyncDate : DateTime
)

パラメータ

cacheAgeControl

HttpCacheAgeControl 値です。

maxAge

リソースの有効期限を指定する TimeSpan 値。

freshOrStale

期間を指定する TimeSpan 値。詳細については「解説」を参照してください。  

cacheSyncDate

キャッシュされたリソースの再検証が必要となる日時を指定する DateTime オブジェクト。

解説解説

cacheAgeControl 値は、freshOrStale パラメータ値の意味を解釈し、関連プロパティを設定するために使用されます。たとえば、MaxStale を指定すると、MaxStale プロパティは freshOrStale パラメータの値に設定されます。MaxAgeAndMaxStale を指定すると、maxAge パラメータの値を使用して MaxAge プロパティが設定され、freshOrStale パラメータの値を指定して MaxStale プロパティが設定されます。

MaxAgeAndMaxStale または MaxAgeAndMinFresh を指定しない限り、MaxAge プロパティは設定されません。

このコンストラクタは、CacheSyncDate プロパティを cacheSyncDate に初期化し、Level プロパティを Default に初期化します。

使用例使用例

短縮期限、有効期限、およびキャッシュ同期日時に基づいてキャッシュ ポリシーを作成するコード例を次に示します。

public static HttpRequestCachePolicy CreateFreshAndAgePolicy2(TimeSpan
 freshMinimum, TimeSpan ageMaximum, DateTime when)
{
    HttpRequestCachePolicy policy = 
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh,
 ageMaximum, freshMinimum, when); 
    Console.WriteLine(policy.ToString());
    return policy;
    // For the following invocation: CreateFreshAndAgePolicy(new TimeSpan(5,0,0),
 new TimeSpan(10,0,0),         );
    // the output is:
    // Level:Automatic AgeControl:MinFreshAndMaxAge MinFresh:18000 MaxAge:36000
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy コンストラクタ (DateTime)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Public Sub New ( _
    cacheSyncDate As DateTime _
)
Dim cacheSyncDate As DateTime

Dim instance As New HttpRequestCachePolicy(cacheSyncDate)
public HttpRequestCachePolicy (
    DateTime cacheSyncDate
)
public:
HttpRequestCachePolicy (
    DateTime cacheSyncDate
)
public HttpRequestCachePolicy (
    DateTime cacheSyncDate
)
public function HttpRequestCachePolicy (
    cacheSyncDate : DateTime
)

パラメータ

cacheSyncDate

キャッシュされたリソースの再検証が必要となる日時を指定する DateTime オブジェクト。

解説解説
使用例使用例

キャッシュ同期日時に基づいてキャッシュ ポリシーを作成するコード例を次に示します。

public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime
 when)
{
    HttpRequestCachePolicy policy = 
       new HttpRequestCachePolicy(when);
       
    Console.WriteLine("When: {0}", when);
    Console.WriteLine(policy.CacheSyncDate.ToString());
    return policy; 
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy コンストラクタ (HttpRequestCacheLevel)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キャッシュ ポリシーを指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Public Sub New ( _
    level As HttpRequestCacheLevel _
)
Dim level As HttpRequestCacheLevel

Dim instance As New HttpRequestCachePolicy(level)
public HttpRequestCachePolicy (
    HttpRequestCacheLevel level
)
public:
HttpRequestCachePolicy (
    HttpRequestCacheLevel level
)
public HttpRequestCachePolicy (
    HttpRequestCacheLevel level
)
public function HttpRequestCachePolicy (
    level : HttpRequestCacheLevel
)

パラメータ

level

HttpRequestCacheLevel 値です。

解説解説
使用例使用例

キャッシュ内で見つかったリソースをキャッシュから使用できるようにするキャッシュ ポリシーを作成するコード例を次に示します。

public static HttpRequestCachePolicy CreateCacheIfAvailablePolicy()
{
    HttpRequestCachePolicy policy = 
        new HttpRequestCachePolicy(HttpRequestCacheLevel.CacheIfAvailable);
       
    Console.WriteLine(policy.ToString());
    return policy;
    
} 
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy コンストラクタ (HttpCacheAgeControl, TimeSpan)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

保存期間の制御と日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Public Sub New ( _
    cacheAgeControl As HttpCacheAgeControl, _
    ageOrFreshOrStale As TimeSpan _
)
Dim cacheAgeControl As HttpCacheAgeControl
Dim ageOrFreshOrStale As TimeSpan

Dim instance As New HttpRequestCachePolicy(cacheAgeControl,
 ageOrFreshOrStale)
public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl,
    TimeSpan ageOrFreshOrStale
)
public:
HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan ageOrFreshOrStale
)
public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan ageOrFreshOrStale
)
public function HttpRequestCachePolicy (
    cacheAgeControl : HttpCacheAgeControl, 
    ageOrFreshOrStale : TimeSpan
)

パラメータ

cacheAgeControl

HttpCacheAgeControl 列挙値、つまり MaxAge、MaxStale、または MinFresh の 1 つ。

ageOrFreshOrStale

期間を指定する TimeSpan 値。詳細については「解説」を参照してください。

例外例外
例外の種類条件

ArgumentException

cacheAgeControl パラメータに指定した値が、このコントラクタでは使用できません。

解説解説

cacheAgeControl 値は、ageOrFreshOrStale パラメータの値の意味を定義し、関連プロパティを設定するために使用されます。たとえば、MaxStale を指定すると、MaxStale プロパティは ageOrFreshOrStale パラメータの値に設定されます。

このコンストラクタは、Level プロパティを Default に初期化します。

使用例使用例

短縮期限に基づいてキャッシュ ポリシーを作成するコード例を次に示します。

public static HttpRequestCachePolicy CreateMinFreshPolicy(TimeSpan
 span)
{
    HttpRequestCachePolicy policy = 
        new HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh,
 span); 
    Console.WriteLine("Minimum freshness {0}", policy.MinFresh.ToString());
    return policy;
} 

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy コンストラクタ

HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
HttpRequestCachePolicy () HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
HttpRequestCachePolicy (DateTime) キャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
HttpRequestCachePolicy (HttpRequestCacheLevel) キャッシュ ポリシーを指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
HttpRequestCachePolicy (HttpCacheAgeControl, TimeSpan) 保存期間の制御と日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
HttpRequestCachePolicy (HttpCacheAgeControl, TimeSpan, TimeSpan) 有効期限、保存期間の制御値、および日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
HttpRequestCachePolicy (HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) 有効期限、保存期間の制御値、日時の値、およびキャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
参照参照

関連項目

HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy コンストラクタ (HttpCacheAgeControl, TimeSpan, TimeSpan)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

有効期限、保存期間の制御値、および日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文構文

Public Sub New ( _
    cacheAgeControl As HttpCacheAgeControl, _
    maxAge As TimeSpan, _
    freshOrStale As TimeSpan _
)
Dim cacheAgeControl As HttpCacheAgeControl
Dim maxAge As TimeSpan
Dim freshOrStale As TimeSpan

Dim instance As New HttpRequestCachePolicy(cacheAgeControl,
 maxAge, freshOrStale)
public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl,
    TimeSpan maxAge,
    TimeSpan freshOrStale
)
public:
HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale
)
public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale
)
public function HttpRequestCachePolicy (
    cacheAgeControl : HttpCacheAgeControl, 
    maxAge : TimeSpan, 
    freshOrStale : TimeSpan
)

パラメータ

cacheAgeControl

HttpCacheAgeControl 値です。

maxAge

リソースの有効期限を指定する TimeSpan 値。

freshOrStale

期間を指定する TimeSpan 値。詳細については「解説」を参照してください。  

例外例外
例外の種類条件

ArgumentException

cacheAgeControl パラメータに指定された値が無効です。

解説解説

cacheAgeControl 値は、freshOrStale パラメータ値の意味を解釈し、関連プロパティを設定するために使用されます。たとえば、MaxStale を指定すると、MaxStale プロパティは freshOrStale パラメータの値に設定されます。MaxAgeAndMaxStale を指定すると、maxAge パラメータの値を使用して MaxAge プロパティが設定され、freshOrStale パラメータの値を指定して MaxStale プロパティが設定されます。

MaxAgeAndMaxStale または MaxAgeAndMinFresh を指定しない限り、MaxAge プロパティは設定されません。

このコンストラクタは、Level プロパティを Default に初期化します。

使用例使用例

短縮期限と有効期限に基づいてキャッシュ ポリシーを作成するコード例を次に示します。

public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan
 freshMinimum, TimeSpan ageMaximum)
{
    HttpRequestCachePolicy policy = 
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh,
 ageMaximum, freshMinimum); 
    Console.WriteLine(policy.ToString());
    return policy; 
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

HttpRequestCachePolicy プロパティ


HttpRequestCachePolicy メソッド


HttpRequestCachePolicy メンバ

HttpWebRequest オブジェクトを使用して取得されるリソースに対するアプリケーションのキャッシュ要件を定義します。

HttpRequestCachePolicy データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド HttpRequestCachePolicy オーバーロードされます。 HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

HttpRequestCachePolicy クラス
System.Net.Cache 名前空間

その他の技術情報

ネットワーク アプリケーションのキャッシュ管理



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「HttpRequestCachePolicy」の関連用語

HttpRequestCachePolicyのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



HttpRequestCachePolicyのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS