ObjectCache.Add Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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)
- Quelle:
- ObjectCache.cs
- Quelle:
- ObjectCache.cs
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 -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As BooleanParameter
- 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
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.
Gilt für:
Add(String, Object, DateTimeOffset, String)
- Quelle:
- ObjectCache.cs
- Quelle:
- ObjectCache.cs
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 -> boolPublic Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As BooleanParameter
- 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
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.
Gilt für:
Add(String, Object, CacheItemPolicy, String)
- Quelle:
- ObjectCache.cs
- Quelle:
- ObjectCache.cs
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 -> boolPublic Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As BooleanParameter
- 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
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.
