CacheItemPriority 列挙体

.NET Framework クラス ライブラリ リファレンス

CacheItemPriority 列挙体

Cache オブジェクトに格納されている項目の相対優先順位を指定します。

名前空間: System.Web.Caching
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Enumeration CacheItemPriority

Visual Basic (使用法)

Dim instance As CacheItemPriority

C#

public enum CacheItemPriority

C++

public enum class CacheItemPriority

J#

public enum CacheItemPriority

JScript

public enum CacheItemPriority

メンバ

	メンバ名	説明
	AboveNormal	この優先順位のキャッシュ項目は、Normal の優先順位が割り当てられている項目に比べ、サーバーがシステム メモリを解放するときに削除される可能性が低くなります。
	BelowNormal	この優先順位のキャッシュ項目は、Normal の優先度が割り当てられている項目に比べ、サーバーがシステム メモリを解放するときに削除される可能性が高くなります。
	Default	キャッシュ項目の優先順位の既定値は Normal です。
	High	この優先順位のキャッシュ項目は、サーバーがシステム メモリを解放するときにキャッシュから削除される可能性が最も低くなります。
	Low	この優先順位のキャッシュ項目は、サーバーがシステム メモリを解放するときにキャッシュから削除される可能性が最も高くなります。
	Normal	この優先順位のキャッシュ項目は、Low または BelowNormal の優先順位のキャッシュ項目が削除された後に限り、サーバーがシステム メモリを解放するときにキャッシュから削除されます。これは、既定の設定です。
	NotRemovable	この優先順位のキャッシュ項目は、サーバーがシステム メモリを解放するときにキャッシュから自動的に削除されません。ただし、この優先順位の項目は、項目の絶対有効期限またはスライド式有効期限に従って、他の項目と共に削除されます。

解説

ASP.NET アプリケーションをホストしている Web サーバーがメモリ不足の状態で実行されていると、Cache は項目を選択してパージし、システム メモリを解放します。項目をキャッシュに追加するときに、キャッシュ内に格納されている他の項目と比較した相対優先順位をその項目に割り当てることができます。高い優先順位値を割り当てた項目は、サーバーが多くの要求を処理している場合にキャッシュから削除される可能性は低くなります。一方、低い優先度値を割り当てた項目は、このような場合にキャッシュから削除される可能性が高くなります。既定値は Normal です。

メモ
キャッシュの優先順位に関係なく、項目はプログラムによっていつでもキャッシュから削除できます。

使用例

Insert メソッドを使用して、priority パラメータを High に設定した Cache オブジェクトに項目を追加するコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>
<Script runat="server">
    Public Sub Page_Load(sender As
 Object, e As EventArgs)
        Dim connectionString As String
        connectionString = "Data Source=localhost;Integrated Security=SSPI"
        Cache.Insert("DSN", connectionString, Nothing,
 DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, Nothing)
    End Sub
</Script>

C#

<Script language="C#" runat="server">
    public void Page_Load(Object sender, EventArgs
 e) {
        String connectionString;
        connectionString = "Data Source=localhost;Integrated Security=SSPI";
        Cache.Insert("DSN", connectionString, null,
 DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, null);
    }
</Script>

JScript

<Script language="JScript" runat="server">
    public function Page_Load(sender : Object,
 e : EventArgs) : void  {
        var connectionString : String;
        connectionString = "Data Source=localhost;Integrated Security=SSPI";
        Cache.Insert("DSN", connectionString, null,
 DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, null);
    }
</Script>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
System.Web.Caching 名前空間
Cache クラス
その他の技術情報
アプリケーション データのキャッシュ