ObjectCache.Set 方法

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v9.0.0

在衍生類別中遭覆寫時，在快取區中插入快取項目。

多載

Set(CacheItem, CacheItemPolicy)	在衍生類別中遭覆寫時，在快取中插入快取項目做為 CacheItem 執行個體，並指定關於要如何收回項目的資訊。
Set(String, Object, DateTimeOffset, String)	在衍生類別中遭覆寫時，在快取中插入快取項目，並指定以時間為基礎的到期詳細資訊。
Set(String, Object, CacheItemPolicy, String)	在衍生類別中遭覆寫時，在快取區中插入快取項目。

備註

多載方法的 Set 一般行為是插入或更新作業。 如果指定的專案不存在，快取專案會插入為新專案，或者如果快取項目已經存在，則會以新的值更新快取專案。

Set(CacheItem, CacheItemPolicy)

來源:

ObjectCache.cs

在衍生類別中遭覆寫時，在快取中插入快取項目做為 CacheItem 執行個體，並指定關於要如何收回項目的資訊。

public:
 abstract void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract void Set (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public MustOverride Sub Set (item As CacheItem, policy As CacheItemPolicy)

參數

item

CacheItem

要加入的快取項目。

policy

CacheItemPolicy

物件，包含快取項目的收回詳細資料。 這個物件提供的收回選項比簡單絕對期限要多。

備註

如果的 item 索引鍵不存在， item 則會插入為新的快取專案。 如果具有符合 item 索引鍵的專案存在，則會使用 中的 item 值來更新或覆寫現有快取專案的值。

Set(String, Object, DateTimeOffset, String)

來源:

ObjectCache.cs

在衍生類別中遭覆寫時，在快取中插入快取項目，並指定以時間為基礎的到期詳細資訊。

public abstract void Set (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Set : string * obj * DateTimeOffset * string -> unit

Public MustOverride Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

參數

key

String

快取項目的唯一識別項。

value

Object

要插入的物件。

absoluteExpiration

DateTimeOffset

快取項目到期的固定日期和時間。

regionName

String

選擇性。 如果已實作區域，則為快取區中的具名區域，快取項目可以加入至這個區域。 選擇性參數的預設值為 null。

備註

如果符合 key 的專案不存在於快取中， value 則會 key 用來插入為新的快取專案。 如果索引鍵相符 item 的專案存在，則會使用 value來更新或覆寫快取專案。

Set(String, Object, CacheItemPolicy, String)

來源:

ObjectCache.cs

在衍生類別中遭覆寫時，在快取區中插入快取項目。

public abstract void Set (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit

Public MustOverride Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)

參數

key

String

快取項目的唯一識別項。

value

Object

要插入的物件。

policy

CacheItemPolicy

物件，包含快取項目的收回詳細資料。 這個物件提供的收回選項比簡單絕對期限要多。

regionName

String

選擇性。 如果已實作區域，則為快取區中的具名區域，快取項目可以加入至這個區域。 選擇性參數的預設值為 null。

備註

這個方法多載可讓您提供比以時間為基礎的絕對到期所提供的詳細數據更多的收回或到期詳細數據。

如果符合 key 的專案不存在於快取中， value 則會 key 用來插入為新的快取專案。 如果索引鍵相符 item 的專案存在，則會使用 value來更新或覆寫快取專案。