HttpRequestCachePolicy コンストラクタとは何？わかりやすく解説 Weblio辞書

メモ : このコンストラクタは、.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 _
)

Visual Basic (使用法)

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)

C#

public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl,
    TimeSpan maxAge,
    TimeSpan freshOrStale,
    DateTime cacheSyncDate
)

C++

public:
HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale, 
    DateTime cacheSyncDate
)

J#

public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale, 
    DateTime cacheSyncDate
)

JScript

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 に初期化します。

使用例

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

C#

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
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    cacheSyncDate As DateTime _
)

Visual Basic (使用法)

Dim cacheSyncDate As DateTime

Dim instance As New HttpRequestCachePolicy(cacheSyncDate)

C#

public HttpRequestCachePolicy (
    DateTime cacheSyncDate
)

C++

public:
HttpRequestCachePolicy (
    DateTime cacheSyncDate
)

J#

public HttpRequestCachePolicy (
    DateTime cacheSyncDate
)

JScript

public function HttpRequestCachePolicy (
    cacheSyncDate : DateTime
)

パラメータ

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

解説

キャッシュ同期日時により、キャッシュされたコンテンツの再検証が必要となる具体的な日時を指定できます。キャッシュエントリが最後に再検証された日時がキャッシュ同期日時より前の場合、サーバーでの再検証が発生します。キャッシュエントリがキャッシュ同期日時以降に再検証されていて、キャッシュされたエントリを無効にするサーバー再検証要件がない場合は、キャッシュのエントリが使用されます。キャッシュ同期日時が将来の日付に設定されている場合、エントリは、キャッシュ同期日時が過ぎるまで、要求されるたびに再検証されます。

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

使用例

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

C#

public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime
 when)
{
    HttpRequestCachePolicy policy = 
       new HttpRequestCachePolicy(when);
       
    Console.WriteLine("When: {0}", when);
    Console.WriteLine(policy.CacheSyncDate.ToString());
    return policy; 
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    level As HttpRequestCacheLevel _
)

Visual Basic (使用法)

Dim level As HttpRequestCacheLevel

Dim instance As New HttpRequestCachePolicy(level)

C#

public HttpRequestCachePolicy (
    HttpRequestCacheLevel level
)

C++

public:
HttpRequestCachePolicy (
    HttpRequestCacheLevel level
)

J#

public HttpRequestCachePolicy (
    HttpRequestCacheLevel level
)

JScript

public function HttpRequestCachePolicy (
    level : HttpRequestCacheLevel
)

パラメータ

level: HttpRequestCacheLevel 値です。

解説

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

HttpRequestCacheLevel 値は、キャッシュが有効になっているかどうかと、いつキャッシュを使用できるかを制御します。詳細については、HttpRequestCacheLevel のトピックを参照してください。

使用例

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

C#

public static HttpRequestCachePolicy CreateCacheIfAvailablePolicy()
{
    HttpRequestCachePolicy policy = 
        new HttpRequestCachePolicy(HttpRequestCacheLevel.CacheIfAvailable);
       
    Console.WriteLine(policy.ToString());
    return policy;
    
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim cacheAgeControl As HttpCacheAgeControl
Dim ageOrFreshOrStale As TimeSpan

Dim instance As New HttpRequestCachePolicy(cacheAgeControl,
 ageOrFreshOrStale)

C#

public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl,
    TimeSpan ageOrFreshOrStale
)

C++

public:
HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan ageOrFreshOrStale
)

J#

public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan ageOrFreshOrStale
)

JScript

public function HttpRequestCachePolicy (
    cacheAgeControl : HttpCacheAgeControl, 
    ageOrFreshOrStale : TimeSpan
)

パラメータ

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

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

例外

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

解説

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

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

使用例

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

C#

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

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 名前空間

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim cacheAgeControl As HttpCacheAgeControl
Dim maxAge As TimeSpan
Dim freshOrStale As TimeSpan

Dim instance As New HttpRequestCachePolicy(cacheAgeControl,
 maxAge, freshOrStale)

C#

public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl,
    TimeSpan maxAge,
    TimeSpan freshOrStale
)

C++

public:
HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale
)

J#

public HttpRequestCachePolicy (
    HttpCacheAgeControl cacheAgeControl, 
    TimeSpan maxAge, 
    TimeSpan freshOrStale
)

JScript

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 に初期化します。

使用例

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

C#

public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan
 freshMinimum, TimeSpan ageMaximum)
{
    HttpRequestCachePolicy policy = 
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh,
 ageMaximum, freshMinimum); 
    Console.WriteLine(policy.ToString());
    return policy; 
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpRequestCachePolicy クラス
HttpRequestCachePolicy メンバ
System.Net.Cache 名前空間

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New HttpRequestCachePolicy

C#

public HttpRequestCachePolicy ()

C++

public:
HttpRequestCachePolicy ()

J#

public HttpRequestCachePolicy ()

JScript

public function HttpRequestCachePolicy ()

解説

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

使用例

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

C#

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