ObjectCache.Add Methode

Definition

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Paket:

System.Runtime.Caching v9.0.0-rc.2.24473.5

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.

Ü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.
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.
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.

Hinweise

Die Add Methodenüberladungen versuchen, einen Cacheeintrag in den Cache einzufügen, ohne einen vorhandenen Cacheeintrag mit demselben Schlüssel zu überschreiben oder zu entfernen. Der Cacheeintrag kann ein typisiertes CacheItem Objekt oder ein generisches Objekt sein.

Die AddOrGetExisting Methodenüberladungen und die Add Methodenüberladungen weisen einen signifikanten Unterschied auf. Wenn diese Methoden einen Cacheeintrag einfügen und ein übereinstimmenden Eintrag im Cache gefunden wird, geben die AddOrGetExisting Methodenüberladungen den vorhandenen Cacheeintrag zurück, die Add Methodenüberladungen jedoch nicht. Mit diesen verschiedenen Methodenüberladungen können Aufrufer ihren Code optimieren, je nachdem, ob sie den vorhandenen Cacheeintrag benötigen. In verteilten Caches kann das Zurückgeben eines vorhandenen Werts mithilfe der AddOrGetExisting -Methode teurer sein als das Zurückgeben eines booleschen Werts mithilfe Add der -Methode.

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.

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.

policy

CacheItemPolicy

Ein Objekt, das Entfernungsdetails für den Cacheeintrag enthält. Dieses Objekt stellt mehr Optionen für das Entfernen bereit als ein einfacher absoluter Ablauf.

Gibt zurück

Boolean

true, wenn der Eintrag eingefügt wird, oder false, wenn bereits ein Eintrag mit demselben Schlüssel wie item im Cache vorhanden ist.

Hinweise

Die Add Methodenüberladungen sind für die ObjectCache -Klasse virtuell (nicht abstrakt), da die Add -Methode intern aufruft AddOrGetExisting. Dadurch wird die Anzahl der Methodenüberladungen verringert, die ein Cacheimplementierer bereitstellen muss. Wenn eine Cacheimplementierung kein besonderes Verhalten für die Add Methode erfordert, kann sie einfach die AddOrGetExisting Methodenüberladungen implementieren.

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.

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

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 = Nothing) As Boolean

Parameter

key

String

Ein eindeutiger Bezeichner für den Cacheeintrag.

value

Object

Das einzufügende Objekt.

absoluteExpiration

DateTimeOffset

Das feste Datum und die Uhrzeit, an dem bzw. zu der der Cacheeintrag abläuft. Dieser Parameter ist erforderlich, wenn die Add-Methode aufgerufen wird.

regionName

String

Dies ist optional. Ein benannter Bereich im Cache, dem der Cacheeintrag hinzugefügt werden kann, falls Bereiche implementiert werden. Da Regionen in .NET Framework 4 nicht implementiert werden, lautet nullder Standardwert .

Gibt zurück

Boolean

true, wenn der Eintrag eingefügt wird, oder false, wenn bereits ein Eintrag mit demselben Schlüssel wie key im Cache vorhanden ist.

Hinweise

Die Add Methodenüberladungen sind für die ObjectCache -Klasse virtuell (nicht abstrakt), da die Add -Methode intern aufruft AddOrGetExisting. Dadurch wird die Anzahl der Methodenüberladungen verringert, die ein Cacheimplementierer bereitstellen muss. Wenn eine Cacheimplementierung kein besonderes Verhalten für die Add Methode erfordert, kann sie einfach die AddOrGetExisting Methodenüberladungen implementieren.

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.

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

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 = Nothing) As Boolean

Parameter

key

String

Ein eindeutiger Bezeichner für den Cacheeintrag.

value

Object

Das einzufügende Objekt.

policy

CacheItemPolicy

Ein Objekt, das Entfernungsdetails für den Cacheeintrag enthält. Dieses Objekt stellt mehr Optionen für das Entfernen bereit als ein einfacher absoluter Ablauf.

regionName

String

Dies ist optional. Ein benannter Bereich im Cache, dem der Cacheeintrag hinzugefügt werden kann, falls Bereiche implementiert werden. Der Standardwert für den optionalen Parameter ist null.

Gibt zurück

Boolean

true, wenn der Eintrag erfolgreich eingefügt wird, oder false, wenn bereits ein Eintrag mit demselben Schlüssel wie key im Cache vorhanden ist.

Hinweise

Die Add Methodenüberladungen sind für die ObjectCache -Klasse virtuell (nicht abstrakt), da die Add -Methode intern aufruft AddOrGetExisting. Dadurch wird die Anzahl der Methodenüberladungen verringert, die ein Cacheimplementierer bereitstellen muss. Wenn eine Cacheimplementierung kein besonderes Verhalten für die Add Methode erfordert, kann sie einfach die AddOrGetExisting Methodenüberladungen implementieren.