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 sie in einer abgeleiteten Klasse überschrieben wird, wird ein Cacheeintrag in den Cache eingefügt, ohne dass ein vorhandener Cacheeintrag mit einem übereinstimmenden Schlüssel zurückgegeben werden muss.
Überlädt
| Name | Beschreibung |
|---|---|
| Add(CacheItem, CacheItemPolicy) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, versucht, einen Cacheeintrag als CacheItem Instanz in den Cache einzufügen, und fügt Details dazu hinzu, wie der Eintrag gelöscht werden soll. |
| Add(String, Object, DateTimeOffset, String) |
Beim Überschreiben in einer abgeleiteten Klasse wird ein Cacheeintrag in den Cache eingefügt, ohne einen vorhandenen Cacheeintrag zu überschreiben. |
| Add(String, Object, CacheItemPolicy, String) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird ein Cacheeintrag in den Cache eingefügt, der Informationen darüber angibt, 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 typiertes 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, wenn ein übereinstimmenden Eintrag im Cache gefunden wird, geben die AddOrGetExisting Methodenüberladungen den vorhandenen Cacheeintrag zurück, aber die Add Methodenüberladungen nicht. Mit diesen verschiedenen Methodenüberladungen können Aufrufer ihren Code basierend darauf optimieren, 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
- Quelle:
- ObjectCache.cs
- Quelle:
- ObjectCache.cs
Wenn sie in einer abgeleiteten Klasse überschrieben werden, versucht, einen Cacheeintrag als CacheItem Instanz in den Cache einzufügen, und fügt Details dazu hinzu, wie der Eintrag gelöscht werden soll.
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 bietet mehr Optionen für die Entfernung als ein einfaches absolutes Ablaufen.
Gibt zurück
true wenn die Einfügung erfolgreich war, oder false wenn bereits ein Eintrag im Cache vorhanden ist, der denselben Schlüssel aufweist wie item.
Hinweise
Die Add Methodenüberladungen sind virtuell (nicht abstrahiert) für die ObjectCache Klasse, da die Add Methode intern aufruft AddOrGetExisting. Dadurch wird die Anzahl der Methodenüberladungen reduziert, die ein Cacheimplementierer bereitstellen muss. Wenn eine Cacheimplementierung kein spezielles 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
- Quelle:
- ObjectCache.cs
- Quelle:
- ObjectCache.cs
Beim Überschreiben in einer abgeleiteten Klasse wird ein Cacheeintrag in den Cache eingefügt, 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, zu dem 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, wenn Regionen implementiert werden. Da Regionen in .NET Framework 4 nicht implementiert sind, ist der Standardwert null.
Gibt zurück
true wenn die Einfügung erfolgreich war, oder false wenn bereits ein Eintrag im Cache vorhanden ist, der denselben Schlüssel aufweist wie key.
Hinweise
Die Add Methodenüberladungen sind virtuell (nicht abstrahiert) für die ObjectCache Klasse, da die Add Methode intern aufruft AddOrGetExisting. Dadurch wird die Anzahl der Methodenüberladungen reduziert, die ein Cacheimplementierer bereitstellen muss. Wenn eine Cacheimplementierung kein spezielles 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
- Quelle:
- ObjectCache.cs
- Quelle:
- ObjectCache.cs
Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird ein Cacheeintrag in den Cache eingefügt, der Informationen darüber angibt, 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 bietet mehr Optionen für die Entfernung als ein einfaches absolutes Ablaufen.
- regionName
- String
Dies ist optional. Ein benannter Bereich im Cache, dem der Cacheeintrag hinzugefügt werden kann, wenn Regionen implementiert werden. Der Standardwert für den optionalen Parameter lautet null.
Gibt zurück
true wenn die Einfügemarke erfolgreich ist, oder false wenn bereits ein Eintrag im Cache mit demselben Schlüssel vorhanden ist wie key.
Hinweise
Die Add Methodenüberladungen sind virtuell (nicht abstrahiert) für die ObjectCache Klasse, da die Add Methode intern aufruft AddOrGetExisting. Dadurch wird die Anzahl der Methodenüberladungen reduziert, die ein Cacheimplementierer bereitstellen muss. Wenn eine Cacheimplementierung kein spezielles Verhalten für die Add Methode erfordert, kann sie einfach die AddOrGetExisting Methodenüberladungen implementieren.
