MemoryCache クラス

定義

名前空間:

System.Runtime.Caching

アセンブリ:

System.Runtime.Caching.dll

パッケージ:

System.Runtime.Caching v8.0.0

ソース:

MemoryCache.cs

メモリ内キャッシュを実装する型を表します。

public ref class MemoryCache : System::Runtime::Caching::ObjectCache, IDisposable

public class MemoryCache : System.Runtime.Caching.ObjectCache, IDisposable

type MemoryCache = class
    inherit ObjectCache
    interface IEnumerable
    interface IDisposable

Public Class MemoryCache
Inherits ObjectCache
Implements IDisposable

継承

Object

ObjectCache

MemoryCache

実装

IEnumerable IDisposable

例

次の例では、既定のメモリ キャッシュ インスタンスへの参照を宣言します。 キャッシュ エントリは、 オブジェクトを CacheItemPolicy 使用して、キャッシュ エントリの削除と有効期限の詳細を提供します。 また、 オブジェクトを ChangeMonitor 使用して、ファイル システム上のソース データ (ファイル) の状態を監視します。

Private Sub btnGet_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim cache As ObjectCache = MemoryCache.[Default]
    Dim fileContents As String = TryCast(cache("filecontents"), String)

    If fileContents Is Nothing Then
        Dim policy As New CacheItemPolicy()
        Dim filePaths As New List(Of String)()
        filePaths.Add("c:\cache\example.txt")

        policy.ChangeMonitors.Add(New HostFileChangeMonitor(filePaths))

        ' Fetch the file contents.
        fileContents = File.ReadAllText("c:\cache\example.txt")

        cache.[Set]("filecontents", fileContents, policy)
    End If

    Label1.Text = fileContents
End Sub

private void btnGet_Click(object sender, EventArgs e)
{
    ObjectCache cache = MemoryCache.Default;
    string fileContents = cache["filecontents"] as string;

    if (fileContents == null)
    {
        CacheItemPolicy policy = new CacheItemPolicy();

        List<string> filePaths = new List<string>();
        filePaths.Add("c:\\cache\\example.txt");

        policy.ChangeMonitors.Add(new
        HostFileChangeMonitor(filePaths));

        // Fetch the file contents.
        fileContents =
            File.ReadAllText("c:\\cache\\example.txt");

        cache.Set("filecontents", fileContents, policy);
    }

    Label1.Text = fileContents;
}

注釈

MemoryCache クラスは、抽象 ObjectCache クラスの具象実装です。

注意

クラスは MemoryCache 、ASP.NET クラスに Cache 似ています。 MemoryCacheクラスには、ASP.NET Cache クラスを使用した場合に使い慣れたキャッシュにアクセスするための多くのプロパティとメソッドがあります。 クラスと MemoryCache クラスのメイン違Cacheいは、MemoryCacheASP.NET アプリケーションではない.NET Frameworkアプリケーションで使用できるようにクラスが変更されていることです。 たとえば、 MemoryCache クラスにはアセンブリへの System.Web 依存関係はありません。 もう 1 つの違いは、同じアプリケーションと同じインスタンス MemoryCache で使用するために、 クラスの複数のインスタンスを AppDomain 作成できることです。

クラスは MemoryCache 、キャッシュ内の値として を許可 null しません。 値が の null キャッシュ エントリを追加または変更しようとすると失敗します。

型はMemoryCacheキャッシュ領域を実装しません。 したがって、リージョンのパラメーターを含む基本メソッドを実装するメソッドを呼び出 MemoryCache すときは、 パラメーターの値を渡さないでください。 region パラメーターを使用するメソッドはすべて、既定値を指定します null 。 たとえば、メソッドの MemoryCache.AddOrGetExisting オーバーロードには regionName 、既定値が である パラメーターがあります null。

コンストラクター

MemoryCache(String, NameValueCollection)	MemoryCache クラスの新しいインスタンスを初期化します。
MemoryCache(String, NameValueCollection, Boolean)	MemoryCache クラスの新しいインスタンスを初期化します。

プロパティ

CacheMemoryLimit	キャッシュに使用できるコンピューターのメモリの量をバイト単位で取得します。
Default	既定の MemoryCache インスタンスへの参照を取得します。
DefaultCacheCapabilities	キャッシュが提供する機能の説明を取得します。
Item[String]	MemoryCache クラスのインスタンスの既定のインデクサー プロパティを使用して、キャッシュ内の値を取得または設定します。
Name	キャッシュの名前を取得します。
PhysicalMemoryLimit	キャッシュが使用できる物理メモリの割合を取得します。
PollingInterval	キャッシュがメモリ統計情報を更新するまでの最大時間を取得します。

メソッド

Add(CacheItem, CacheItemPolicy)	キャッシュ エントリを CacheItem インスタンスとしてキャッシュに挿入し、このエントリの削除方法の詳細を追加します。
Add(String, Object, CacheItemPolicy, String)	派生クラスでオーバーライドされると、キャッシュ エントリをキャッシュに挿入し、エントリの削除方法に関する情報を指定します。 (継承元 ObjectCache)
Add(String, Object, DateTimeOffset, String)	派生クラスでオーバーライドされると、既存のキャッシュ エントリを上書きせずに、キャッシュ エントリをキャッシュに挿入します。 (継承元 ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	指定した CacheItem インスタンスおよびエントリの削除方法の詳細を使用して、キャッシュ エントリをキャッシュに追加します。
AddOrGetExisting(String, Object, CacheItemPolicy, String)	指定したキーと値およびキャッシュ エントリの削除方法の詳細を使用して、キャッシュ エントリをキャッシュに挿入します。
AddOrGetExisting(String, Object, DateTimeOffset, String)	指定したキーと値および絶対有効期限の値を使用して、キャッシュ エントリをキャッシュに追加します。
Contains(String, String)	キャッシュ エントリがキャッシュに存在するかどうかを判断します。
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	指定したキャッシュ エントリの変更に応答してイベントを発生させることができる CacheEntryChangeMonitor オブジェクトを作成します。
Dispose()	MemoryCache クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Get(String, String)	キャッシュからエントリを返します。
GetCacheItem(String, String)	指定したエントリをキャッシュから CacheItem インスタンスとして返します。
GetCount(String)	キャッシュ内のキャッシュ エントリの合計数を返します。
GetEnumerator()	キャッシュ エントリのコレクションを反復処理するために使用できる列挙子を作成します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLastSize(String)	名前付き領域のサイズを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValues(IEnumerable<String>, String)	指定したキーに対応するキャッシュ エントリのセットを返します。
GetValues(String, String[])	指定したキーに対応するキャッシュ エントリのセットを取得します。 (継承元 ObjectCache)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Remove(String, CacheEntryRemovedReason, String)	理由を使用してキャッシュからキャッシュ エントリを削除します。
Remove(String, String)	キャッシュからキャッシュ エントリを削除します。
Set(CacheItem, CacheItemPolicy)	キャッシュ エントリのキーと値を指定するために CacheItem インスタンスを使用して、キャッシュ エントリをキャッシュに挿入します。
Set(String, Object, CacheItemPolicy, String)	キーと値および削除の詳細を使用して、キャッシュ エントリをキャッシュに挿入します。
Set(String, Object, DateTimeOffset, String)	キーと値を使用してキャッシュ エントリをキャッシュに挿入し、時間ベースの有効期限の詳細を指定します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Trim(Int32)	指定した割合のキャッシュ エントリをキャッシュ オブジェクトから削除します。

明示的なインターフェイスの実装

IEnumerable.GetEnumerator()	ジェネリック コレクションに対する反復処理をサポートします。
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	厳密に型指定されたコレクションに対する繰り返し処理をサポートします。 (継承元 ObjectCache)

拡張メソッド

スレッド セーフ

この型はスレッド セーフです。

こちらもご覧ください

• ObjectCache
• チュートリアル: ASP.NET 内のアプリケーション データのキャッシュ
• .NET Framework アプリケーションでのキャッシュ