ObjectCache.Add Methode

Definition

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein, ohne dass ein vorhandener Cacheeintrag mit einem übereinstimmenden Schlüssel zurückgegeben werden muss.When overridden in a derived class, inserts a cache entry into the cache, without requiring that an existing cache entry with a matching key be returned.

Überlädt

Add(CacheItem, CacheItemPolicy)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, versucht sie, einen Cacheeintrag als CacheItem-Instanz in den Cache einzufügen, und fügt Details zur Entfernung des Eintrags hinzu.When overridden in a derived class, tries to insert a cache entry into the cache as a CacheItem instance, and adds details about how the entry should be evicted.

Add(String, Object, DateTimeOffset, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein, ohne einen vorhandenen Cacheeintrag zu überschreiben.When overridden in a derived class, inserts a cache entry into the cache without overwriting any existing cache entry.

Add(String, Object, CacheItemPolicy, String)

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

Hinweise

Die Add Methoden Überladungen versuchen, einen Cache Eintrag in den Cache einzufügen, ohne einen vorhandenen Cache Eintrag mit demselben Schlüssel zu überschreiben oder zu entfernen.The Add method overloads try to insert a cache entry into the cache, without overwriting or removing an existing cache entry that has the same key. Der Cache Eintrag kann ein typisiertes CacheItem -Objekt oder ein generisches-Objekt sein.The cache entry can be a typed CacheItem object or a generic object.

Die AddOrGetExisting -Methoden Überladungen und Add die-Methoden Überladungen haben einen signifikanten Unterschied.The AddOrGetExisting method overloads and the Add method overloads have one significant difference. Wenn diese Methoden einen Cache Eintrag einfügen, wenn ein übereinstimmender Eintrag im Cache gefunden wird, AddOrGetExisting gibt die Methoden Überladungen den vorhandenen Cache Eintrag zurück, Add die Methoden Überladungen jedoch nicht.When these methods insert a cache entry, if a matching entry is found in the cache, the AddOrGetExisting method overloads return the existing cache entry, but the Add method overloads do not. Durch diese unterschiedlichen Methoden Überladungen können Aufrufer Ihren Code basierend darauf optimieren, ob Sie den vorhandenen Cache Eintrag benötigen.Having these different method overloads enables callers to optimize their code based on whether they need the existing cache entry. In verteilten Caches kann das Zurückgeben eines vorhandenen Werts mithilfe AddOrGetExisting der-Methode kostengünstiger sein als die Rückgabe eines booleschen Werts Add mithilfe der-Methode.In distributed caches, returning an existing value by using the AddOrGetExisting method might be more expensive than returning a Boolean value by using Add method.

Add(CacheItem, CacheItemPolicy)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, versucht sie, einen Cacheeintrag als CacheItem-Instanz in den Cache einzufügen, und fügt Details zur Entfernung des Eintrags hinzu.When overridden in a derived class, tries to insert a cache entry into the cache as a CacheItem instance, and adds details about how the entry should be evicted.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);
public virtual bool Add (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);
abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

Parameter

item
CacheItem

Das hinzuzufügende Objekt.The object 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.

Gibt zurück

true, wenn der Eintrag eingefügt wird, oder false, wenn bereits ein Eintrag mit demselben Schlüssel wie item im Cache vorhanden ist.true if insertion succeeded, or false if there is an already an entry in the cache that has the same key as item.

Hinweise

Die Add Methoden Überladungen sind in der ObjectCache -Klasse virtuell (nicht abstrakt), da Add die-Methode AddOrGetExistingintern aufruft.The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. Dadurch wird die Anzahl von Methoden Überladungen reduziert, die von einem cacheimplementierer bereitgestellt werden müssen.This reduces the number of method overloads that a cache implementer has to provide. Wenn eine Cache Implementierung kein spezielles Verhalten für die Add -Methode erfordert, kann Sie einfach die AddOrGetExisting -Methoden Überladungen implementieren.If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

Add(String, Object, DateTimeOffset, String)

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein, ohne einen vorhandenen Cacheeintrag zu überschreiben.When overridden in a derived class, inserts a cache entry into the cache without overwriting any existing cache entry.

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = null);
abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool
Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = null) As Boolean

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. Dieser Parameter ist erforderlich, wenn die Add-Methode aufgerufen wird.This parameter is required when the Add method is called.

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. Da Bereiche in .NET Framework 4.NET Framework 4 nicht implementiert werden, ist der Standardwert null.Because regions are not implemented in .NET Framework 4.NET Framework 4, the default value is null.

Gibt zurück

true, wenn der Eintrag eingefügt wird, oder false, wenn bereits ein Eintrag mit demselben Schlüssel wie key im Cache vorhanden ist.true if insertion succeeded, or false if there is an already an entry in the cache that has the same key as key.

Hinweise

Die Add Methoden Überladungen sind in der ObjectCache -Klasse virtuell (nicht abstrakt), da Add die-Methode AddOrGetExistingintern aufruft.The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. Dadurch wird die Anzahl von Methoden Überladungen reduziert, die von einem cacheimplementierer bereitgestellt werden müssen.This reduces the number of method overloads that a cache implementer has to provide. Wenn eine Cache Implementierung kein spezielles Verhalten für die Add -Methode erfordert, kann Sie einfach die AddOrGetExisting -Methoden Überladungen implementieren.If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

Add(String, Object, CacheItemPolicy, String)

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

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = null);
abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = null) As Boolean

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.

Gibt zurück

true, wenn der Eintrag erfolgreich eingefügt wird, oder false, wenn bereits ein Eintrag mit demselben Schlüssel wie key im Cache vorhanden ist.true if the insertion try succeeds, or false if there is an already an entry in the cache with the same key as key.

Hinweise

Die Add Methoden Überladungen sind in der ObjectCache -Klasse virtuell (nicht abstrakt), da Add die-Methode AddOrGetExistingintern aufruft.The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. Dadurch wird die Anzahl von Methoden Überladungen reduziert, die von einem cacheimplementierer bereitgestellt werden müssen.This reduces the number of method overloads that a cache implementer has to provide. Wenn eine Cache Implementierung kein spezielles Verhalten für die Add -Methode erfordert, kann Sie einfach die AddOrGetExisting -Methoden Überladungen implementieren.If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

Gilt für: