DataCache.Add メソッド (String, Object, ジェネリック IEnumerable, String)

キャッシュ内のリージョンにオブジェクトを追加します。 このメソッドにより、キャッシュ内のオブジェクトとのタグの関連付けが可能になります。

名前空間: Microsoft.ApplicationServer.Caching
アセンブリ: Microsoft.ApplicationServer.Caching.Client (microsoft.applicationserver.caching.client.dll)

使用法

構文

'宣言
Public Function Add ( _
    key As String, _
    value As Object, _
    tags As IEnumerable(Of DataCacheTag), _
    region As String _
) As DataCacheItemVersion

public DataCacheItemVersion Add (
    string key,
    Object value,
    IEnumerable<DataCacheTag> tags,
    string region
)

public:
DataCacheItemVersion^ Add (
    String^ key, 
    Object^ value, 
    IEnumerable<DataCacheTag^>^ tags, 
    String^ region
)

public DataCacheItemVersion Add (
    String key, 
    Object value, 
    IEnumerable<DataCacheTag> tags, 
    String region
)

public function Add (
    key : String, 
    value : Object, 
    tags : IEnumerable<DataCacheTag>, 
    region : String
) : DataCacheItemVersion

パラメーター

• key
  キャッシュとの間でオブジェクトを格納および取得するために使用される一意の値です。

• value
  キャッシュ クラスターに保存されるオブジェクトです。

• tags
  キャッシュされたオブジェクトと関連付ける DataCacheTag オブジェクトの配列です。

• region
  オブジェクトを保存するリージョンの名前です。

戻り値

キー値の下でキャッシュに保存されるオブジェクトのバージョンを表す DataCacheItemVersion オブジェクトです。

解説

同じキーを使用する項目が既にリージョン内に存在する場合、この呼び出しは、ErrorCode を KeyAlreadyExists に設定して、型 DataCacheException の例外をスローします。 有効期限の設定は、名前付きキャッシュの構成から派生します。 詳細については、「有効期限と削除」を参照してください。 このメソッドの使用方法の詳細については、「[HOWTO] オブジェクトをキャッシュに追加する」を参照してください。

スレッド セーフ

この型のパブリック静的 (Visual Basic では Shared ) メンバーはスレッド セーフです。インスタンスのメンバーはいずれも、スレッド セーフである保証はありません。

プラットフォーム

開発プラットフォーム

Visual Studio 2010 およびそれ以降, .NET Framework 4

対象プラットフォーム

Windows 7; Windows Server 2008 R2; Windows Server 2008 Service Pack 2; Windows Vista Service Pack 2

関連項目

参照

DataCache クラス
DataCache メンバー
Microsoft.ApplicationServer.Caching 名前空間