ObjectCache.Set Methode

Definition

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache.

Überlädt

Set(CacheItem, CacheItemPolicy)

Fügt beim Überschreiben in einer abgeleiteten Klasse den Cacheeintrag als CacheItem-Instanz im Cache ein und gibt Informationen darüber an, wie der Eintrag entfernt wird.When overridden in a derived class, inserts the cache entry into the cache as a CacheItem instance, specifying information about how the entry will be evicted.

Set(String, Object, DateTimeOffset, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein und gibt zeitbasierte Ablaufdetails an.When overridden in a derived class, inserts a cache entry into the cache, specifying time-based expiration details.

Set(String, Object, CacheItemPolicy, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache.

Hinweise

Das typische Verhalten Set der Überladungs Methoden ist ein Einfüge-oder Aktualisierungs Vorgang.The typical behavior of the Set overload methods is an insert-or-update operation. Ein Cache Eintrag wird entweder als neuer Eintrag eingefügt, wenn der angegebene Eintrag nicht vorhanden ist, oder der Cache Eintrag wird mit einem neuen Wert aktualisiert, wenn er bereits vorhanden ist.A cache entry is either inserted as a new entry if the specified entry does not exist, or the cache entry is updated with a new value if it already exists.

Set(CacheItem, CacheItemPolicy)

Fügt beim Überschreiben in einer abgeleiteten Klasse den Cacheeintrag als CacheItem-Instanz im Cache ein und gibt Informationen darüber an, wie der Eintrag entfernt wird.When overridden in a derived class, inserts the cache entry into the cache as a CacheItem instance, specifying information about how the entry will be evicted.

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)

Parameter

item
CacheItem

Das hinzuzufügende Cacheelement.The cache item to add.

policy
CacheItemPolicy

Ein Objekt, das Entfernungsdetails für den Cacheeintrag enthält.An object that contains eviction details for the cache entry. Dieses Objekt stellt mehr Optionen für das Entfernen bereit als ein einfacher absoluter Ablauf.This object provides more options for eviction than a simple absolute expiration.

Hinweise

Wenn der Schlüssel für item nicht vorhanden ist, item wird als neuer Cache Eintrag eingefügt.If the key for item does not exist, item is inserted as a new cache entry. Wenn ein Element mit einem Schlüssel vorhanden ist item , der mit übereinstimmt item , wird der Wert von verwendet, um den Wert des vorhandenen Cache Eintrags zu aktualisieren oder zu überschreiben.If an item with a key that matches item exists, the value from item is used to update or overwrite the value of the existing cache entry.

Set(String, Object, DateTimeOffset, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein und gibt zeitbasierte Ablaufdetails an.When overridden in a derived class, inserts a cache entry into the cache, specifying time-based expiration details.

public abstract void Set (string key, object value, DateTimeOffset absoluteExpiration, string regionName = null);
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 = null)

Parameter

key
String

Ein eindeutiger Bezeichner für den Cacheeintrag.A unique identifier for the cache entry.

value
Object

Das einzufügende Objekt.The object to insert.

absoluteExpiration
DateTimeOffset

Das feste Datum und die Uhrzeit, an dem bzw. zu der der Cacheeintrag abläuft.The fixed date and time at which the cache entry will expire.

regionName
String

Dies ist optional.Optional. Ein benannter Bereich im Cache, dem der Cacheeintrag hinzugefügt werden kann, falls Bereiche implementiert werden.A named region in the cache to which the cache entry can be added, if regions are implemented. Der Standardwert für den optionalen Parameter ist null.The default value for the optional parameter is null.

Hinweise

Wenn ein Element, das key mit übereinstimmt, nicht im Cache value vorhanden key ist, werden und zum Einfügen als neuer Cache Eintrag verwendet.If an item that matches key does not exist in the cache, value and key are used to insert as a new cache entry. Wenn ein Element mit einem Schlüssel vorhanden ist item , der mit übereinstimmt, wird der Cache Eintrag mithilfe valuevon aktualisiert oder überschrieben.If an item with a key that matches item exists, the cache entry is updated or overwritten by using value.

Set(String, Object, CacheItemPolicy, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache.

public abstract void Set (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = null);
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 = null)

Parameter

key
String

Ein eindeutiger Bezeichner für den Cacheeintrag.A unique identifier for the cache entry.

value
Object

Das einzufügende Objekt.The object to insert.

policy
CacheItemPolicy

Ein Objekt, das Entfernungsdetails für den Cacheeintrag enthält.An object that contains eviction details for the cache entry. Dieses Objekt stellt mehr Optionen für das Entfernen bereit als ein einfacher absoluter Ablauf.This object provides more options for eviction than a simple absolute expiration.

regionName
String

Dies ist optional.Optional. Ein benannter Bereich im Cache, dem der Cacheeintrag hinzugefügt werden kann, falls Bereiche implementiert werden.A named region in the cache to which the cache entry can be added, if regions are implemented. Der Standardwert für den optionalen Parameter ist null.The default value for the optional parameter is null.

Hinweise

Diese Methoden Überladung ermöglicht es Ihnen, mehr Entfernungs-oder Ablauf Details bereitzustellen, als diejenigen, die in einem zeitbasierten absoluten Ablauf verfügbar sind.This method overload lets you provide more eviction or expiration details than those that are available in time-based absolute expiration.

Wenn ein Element, das key mit übereinstimmt, nicht im Cache value vorhanden key ist, werden und zum Einfügen als neuer Cache Eintrag verwendet.If an item that matches key does not exist in the cache, value and key are used to insert as a new cache entry. Wenn ein Element mit einem Schlüssel vorhanden ist item , der mit übereinstimmt, wird der Cache Eintrag mithilfe valuevon aktualisiert oder überschrieben.If an item with a key that matches item exists, the cache entry is updated or overwritten by using value.

Gilt für: