HttpRequestCachePolicy クラス
アセンブリ: System (system.dll 内)
構文
解説DefaultCachePolicy プロパティ、アプリケーション構成ファイル、またはコンピュータの構成ファイルを使用して、アプリケーションの既定のキャッシュ ポリシーを指定できます。詳細については、「requestCaching 要素 (ネットワーク設定)」を参照してください。
使用例アプリケーション ドメインの既定のキャッシュ ポリシーを作成し、ある要求について、そのポリシーをオーバーライドするコード例を次に示します。
// 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.Net.Cache.RequestCachePolicy
System.Net.Cache.HttpRequestCachePolicy
スレッド セーフ
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照HttpRequestCachePolicy コンストラクタ ()
アセンブリ: System (system.dll 内)
構文
解説
使用例このコンストラクタを使用してキャッシュ ポリシーを設定するコード例を次に示します。
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; }
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照HttpRequestCachePolicy コンストラクタ (HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)
アセンブリ: 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 値です。
解説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 }
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照HttpRequestCachePolicy コンストラクタ (DateTime)
アセンブリ: System (system.dll 内)
構文
解説キャッシュ同期日時により、キャッシュされたコンテンツの再検証が必要となる具体的な日時を指定できます。キャッシュ エントリが最後に再検証された日時がキャッシュ同期日時より前の場合、サーバーでの再検証が発生します。キャッシュ エントリがキャッシュ同期日時以降に再検証されていて、キャッシュされたエントリを無効にするサーバー再検証要件がない場合は、キャッシュのエントリが使用されます。キャッシュ同期日時が将来の日付に設定されている場合、エントリは、キャッシュ同期日時が過ぎるまで、要求されるたびに再検証されます。
このコンストラクタは、Level プロパティを Default に初期化します。CacheSyncDate プロパティは cacheSyncDate に初期化されます。
使用例
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照HttpRequestCachePolicy コンストラクタ (HttpRequestCacheLevel)
アセンブリ: System (system.dll 内)
構文- level
HttpRequestCacheLevel 値です。
解説このコンストラクタは、Level プロパティを level に初期化します。
HttpRequestCacheLevel 値は、キャッシュが有効になっているかどうかと、いつキャッシュを使用できるかを制御します。詳細については、HttpRequestCacheLevel のトピックを参照してください。
使用例
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照HttpRequestCachePolicy コンストラクタ (HttpCacheAgeControl, TimeSpan)
アセンブリ: System (system.dll 内)
構文Dim cacheAgeControl As HttpCacheAgeControl Dim ageOrFreshOrStale As TimeSpan Dim instance As New HttpRequestCachePolicy(cacheAgeControl, ageOrFreshOrStale)
public:
HttpRequestCachePolicy (
HttpCacheAgeControl cacheAgeControl,
TimeSpan ageOrFreshOrStale
)
public function HttpRequestCachePolicy ( cacheAgeControl : HttpCacheAgeControl, ageOrFreshOrStale : TimeSpan )
例外
解説cacheAgeControl 値は、ageOrFreshOrStale パラメータの値の意味を定義し、関連プロパティを設定するために使用されます。たとえば、MaxStale を指定すると、MaxStale プロパティは ageOrFreshOrStale パラメータの値に設定されます。
使用例
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照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 コンストラクタ (HttpCacheAgeControl, TimeSpan, TimeSpan)
アセンブリ: 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 値です。
例外
解説cacheAgeControl 値は、freshOrStale パラメータ値の意味を解釈し、関連プロパティを設定するために使用されます。たとえば、MaxStale を指定すると、MaxStale プロパティは freshOrStale パラメータの値に設定されます。MaxAgeAndMaxStale を指定すると、maxAge パラメータの値を使用して MaxAge プロパティが設定され、freshOrStale パラメータの値を指定して MaxStale プロパティが設定されます。
MaxAgeAndMaxStale または MaxAgeAndMinFresh を指定しない限り、MaxAge プロパティは設定されません。
使用例
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
参照HttpRequestCachePolicy プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| CacheSyncDate | このインスタンスのキャッシュ同期日時を取得します。 |
| Level | このインスタンスが作成されたときに指定された HttpRequestCacheLevel 値を取得します。 |
| MaxAge | キャッシュから返されるリソースに許可されている有効期限を取得します。 |
| MaxStale | キャッシュから返されるリソースに許可される延長期限を取得します。 |
| MinFresh | キャッシュから返されるリソースに許可される短縮期限を取得します。 |
参照HttpRequestCachePolicy メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| ToString | オーバーライドされます。 このインスタンスの文字列形式を返します。 |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照HttpRequestCachePolicy メンバ
HttpWebRequest オブジェクトを使用して取得されるリソースに対するアプリケーションのキャッシュ要件を定義します。
HttpRequestCachePolicy データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| CacheSyncDate | このインスタンスのキャッシュ同期日時を取得します。 |
| Level | このインスタンスが作成されたときに指定された HttpRequestCacheLevel 値を取得します。 |
| MaxAge | キャッシュから返されるリソースに許可されている有効期限を取得します。 |
| MaxStale | キャッシュから返されるリソースに許可される延長期限を取得します。 |
| MinFresh | キャッシュから返されるリソースに許可される短縮期限を取得します。 |
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| ToString | オーバーライドされます。 このインスタンスの文字列形式を返します。 |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- HttpRequestCachePolicyのページへのリンク