ObjectCache.AddOrGetExisting Methode

Definition

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, versucht sie, einen Cacheeintrag in den Cache einzufügen, und gibt einen vorhandenen Cacheeintrag mit einem übereinstimmenden Schlüssel zurück.When overridden in a derived class, tries to insert a cache entry into the cache, and returns an existing cache entry with a matching key.

Überlädt

AddOrGetExisting(CacheItem, CacheItemPolicy)

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

AddOrGetExisting(String, Object, DateTimeOffset, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag unter Verwendung eines Schlüssels, eines Objekts für den Cacheeintrag, eines absoluten Ablaufwerts und eines optionalen Bereichs zum Hinzufügen des Caches in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache, by using a key, an object for the cache entry, an absolute expiration value, and an optional region to add the cache into.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt einen Cacheeintrag mit einem angegebenen Schlüssel und Wert für den Cacheeintrag sowie Informationen zur Entfernung in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache, specifying a key and a value for the cache entry, and information about how the entry will be evicted.

Hinweise

Die AddOrGetExisting -Methoden Überladungen fügen einen Eintrag in den Cache ein.The AddOrGetExisting method overloads insert an entry into the cache. Wenn bereits ein Cache Eintrag mit einem übereinstimmenden Schlüssel vorhanden ist, wird der vorhandene Eintrag zurückgegeben.If a cache entry with a matching key already exists, they return the existing entry. Der Cache Eintrag kann ein CacheItem -Objekt oder ein generisches-Objekt sein.The cache entry can be a CacheItem object or a generic object.

Es gibt einen Unterschied zwischen AddOrGetExisting den über Ladungen und Add den über Ladungen.There is one difference between the AddOrGetExisting overloads and the Add overloads. Wenn diese überladenen Methoden versuchen, einen Cache Eintrag einzufügen, geben die AddOrGetExisting über Ladungen den vorhandenen Cache Eintrag zurück, wenn ein vorhandener Eintrag gefunden wird, der über einen Schlüssel verfügt, der mit einem vorhandenen eingefügten Cache Eintrag übereinstimmt.When these overloaded methods try to insert a cache entry, if an existing entry is found that has a key that matches an existing inserted cache entry, the AddOrGetExisting overloads return the existing cache entry. Die Add über Ladungen sind nicht.The Add overloads do not.

AddOrGetExisting(CacheItem, CacheItemPolicy)

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

public:
 abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);
public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);
abstract member AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem
Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem

Parameter

value
CacheItem

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.

Gibt zurück

Der angegebene Cacheeintrag, wenn ein Cacheeintrag mit demselben Schlüssel vorhanden ist, andernfalls null.If a cache entry with the same key exists, the specified cache entry; otherwise, null.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag unter Verwendung eines Schlüssels, eines Objekts für den Cacheeintrag, eines absoluten Ablaufwerts und eines optionalen Bereichs zum Hinzufügen des Caches in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache, by using a key, an object for the cache entry, an absolute expiration value, and an optional region to add the cache into.

public abstract object AddOrGetExisting (string key, object value, DateTimeOffset absoluteExpiration, string regionName = null);
abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj
Public MustOverride Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = null) As Object

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.

Gibt zurück

Der Wert des angegebenen Cacheeintrags, wenn ein Cacheeintrag mit demselben Schlüssel vorhanden ist, andernfalls null.If a cache entry with the same key exists, the specified cache entry's value; otherwise, null.

Hinweise

Diese AddOrGetExisting(String, Object, DateTimeOffset, String) Methoden Überladung gibt einen Objektwert zurück, CacheItem kein-Objekt.This AddOrGetExisting(String, Object, DateTimeOffset, String) method overload returns an object value, not a CacheItem object.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt einen Cacheeintrag mit einem angegebenen Schlüssel und Wert für den Cacheeintrag sowie Informationen zur Entfernung in den Cache ein.When overridden in a derived class, inserts a cache entry into the cache, specifying a key and a value for the cache entry, and information about how the entry will be evicted.

public abstract object AddOrGetExisting (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = null);
abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj
Public MustOverride Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = null) As Object

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

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.

Gibt zurück

Der Wert des angegebenen Cacheeintrags, wenn ein Cacheeintrag mit demselben Schlüssel vorhanden ist, andernfalls null.If a cache entry with the same key exists, the specified cache entry's value; otherwise, null.

Hinweise

Die AddOrGetExisting(String, Object, CacheItemPolicy, String) -Methode gibt einen Objektwert zurück, CacheItem kein-Objekt.The AddOrGetExisting(String, Object, CacheItemPolicy, String) method returns an object value, not a CacheItem object.

Gilt für: