MemoryCache.Set Methode

Definition

Namespace:: System.Runtime.Caching

Assembly:: System.Runtime.Caching.dll

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.

Fügt einen Cacheeintrag in den Cache ein.

Überlädt

Name	Beschreibung
Set(CacheItem, CacheItemPolicy)	Fügt einen Cacheeintrag in den Cache ein, indem mithilfe einer CacheItem Instanz der Schlüssel und der Wert für den Cacheeintrag bereitgestellt wird.
Set(String, Object, DateTimeOffset, String)	Fügt einen Cacheeintrag mithilfe eines Schlüssels und eines Werts in den Cache ein und gibt zeitbasierte Ablaufdetails an.
Set(String, Object, CacheItemPolicy, String)	Fügt einen Cacheeintrag mithilfe eines Schlüssels und eines Werts und einer Entfernung in den Cache ein.

Hinweise

Wenn der angegebene Eintrag nicht vorhanden ist, wird er erstellt. Wenn der angegebene Eintrag vorhanden ist, wird er aktualisiert.

Set(CacheItem, CacheItemPolicy)

Fügt einen Cacheeintrag in den Cache ein, indem mithilfe einer CacheItem Instanz der Schlüssel und der Wert für den Cacheeintrag bereitgestellt wird.

public:
 override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override void Set(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)

Parameter

item: CacheItem

Ein Objekt, das einen einzufügenden Cacheeintrag darstellt.

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.

Ausnahmen

ArgumentNullException

item ist null.

– oder –

Die Key Eigenschaft ist null.

– oder –

Die Value Eigenschaft ist null.

ArgumentException

Es wurde eine ungültige Kombination von Argumenten für den Cacheeintrag übergeben. Dies tritt auf, wenn die folgenden Ablaufdetails für das Richtlinienobjekt für den Cacheeintrag festgelegt werden:

Wenn sowohl die absoluten als auch die gleitenden Ablaufwerte des CacheItemPolicy Objekts auf andere Werte als die Standardwerte InfiniteAbsoluteExpiration und NoSlidingExpiration Felder festgelegt sind. Die MemoryCache Klasse kann keine Ablaufrichtlinie basierend auf einem absoluten Ablauf und einem gleitenden Ablauf festlegen. Nur eine Ablaufeinstellung kann explizit festgelegt werden, wenn Sie die MemoryCache Klasse verwenden. Die andere Einstellung muss auf InfiniteAbsoluteExpiration oder NoSlidingExpiration Eigenschaft festgelegt werden.
Wenn sowohl der Entfernungsrückruf als auch der Updaterückruf für CacheItemPolicy das Objekt angegeben sind. Die MemoryCache Klasse unterstützt nur die Verwendung eines Rückruftyps pro Cacheeintrag.

ArgumentOutOfRangeException

Die SlidingExpiration Eigenschaft wird auf einen Wert festgelegt, der kleiner als Zeroist.

– oder –

Die SlidingExpiration Eigenschaft wird auf einen Wert festgelegt, der größer als ein Jahr ist.

– oder –

Dies Priority ist kein Wert der CacheItemPriority Aufzählung.

Hinweise

Wie andere Set Methodenüberladungen platziert die Set Methode immer einen Cachewert im Cache, unabhängig davon, ob bereits ein Eintrag vorhanden ist, der denselben Schlüssel aufweist. Wenn der angegebene Eintrag nicht im Cache vorhanden ist, wird ein neuer Cacheeintrag eingefügt. Wenn der angegebene Eintrag bereits vorhanden ist, wird der Wert aktualisiert.

Gilt für:

Set(String, Object, DateTimeOffset, String)

Fügt einen Cacheeintrag mithilfe eines Schlüssels und eines Werts in den Cache ein und gibt zeitbasierte Ablaufdetails an.

public override void Set(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.Set : string * obj * DateTimeOffset * string -> unit

Public Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

Parameter

key: String

Ein eindeutiger Bezeichner für den einzufügenden Cacheeintrag.

value: Object

Die Daten für den Cacheeintrag.

absoluteExpiration: DateTimeOffset

Das feste Datum und die Uhrzeit, zu dem der Cacheeintrag abläuft.

regionName: String

Ein benannter Bereich im Cache, dem ein Cacheeintrag hinzugefügt werden kann. Übergeben Sie keinen Wert für diesen Parameter. Dieser Parameter ist null standardmäßig, da die MemoryCache Klasse keine Regionen implementiert.

Ausnahmen

NotSupportedException

regionName ist nicht null.

ArgumentNullException

key ist null.

– oder –

value ist null.

ArgumentException

Es wurde eine ungültige Kombination von Argumenten für den Cacheeintrag übergeben. Dies tritt auf, wenn die folgenden Ablaufdetails für das Richtlinienobjekt für den Cacheeintrag festgelegt werden:
Wenn sowohl die absoluten als auch die gleitenden Ablaufwerte für CacheItemPolicy das Objekt auf andere Werte als die Standardwerte von InfiniteAbsoluteExpiration und NoSlidingExpiration. Dies geschieht, da die MemoryCache Klasse ablaufende Einträge nicht basierend auf einem absoluten und einem Gleitablauf unterstützt. Nur eine Ablaufeinstellung kann explizit festgelegt werden, wenn Sie die MemoryCache Klasse verwenden. Die andere Einstellung muss auf InfiniteAbsoluteExpiration oder NoSlidingExpiration.
Wenn sowohl der Entfernungsrückruf als auch der Updaterückruf für CacheItemPolicy das Objekt angegeben sind. Die MemoryCache Klasse unterstützt nur die Verwendung eines Rückruftyps pro Cacheeintrag.

ArgumentOutOfRangeException

Die SlidingExpiration Eigenschaft wird auf einen Wert festgelegt, der kleiner als Zeroist.

– oder –

Die SlidingExpiration Eigenschaft wird auf einen Wert festgelegt, der größer als ein Jahr ist.

– oder –

Die Priority Eigenschaft ist kein Wert der CacheItemPriority Enumeration.

Hinweise

Wie andere Set Methodenüberladungen platziert die Set Methode immer einen Cachewert im Cache, unabhängig davon, ob bereits ein Eintrag mit demselben Schlüssel vorhanden ist. Wenn der angegebene Eintrag nicht vorhanden ist, wird ein neuer Cacheeintrag eingefügt. Wenn der angegebene Eintrag vorhanden ist, wird er aktualisiert.

Der absoluteExpiration Parameter gibt an, wann der Eintrag aus dem Cache entfernt werden soll.

Durch das Entfernen eines Eintrags werden alle zugehörigen Änderungsmonitore ausgelöst. Wenn das entfernte Element einem CacheItemUpdateCallback Objekt oder CacheItemRemovedCallback Objekt zugeordnet wurde, ist der Grund für das Entfernen, das an die Rückrufe übergeben wird, in der Removed Eigenschaft enthalten.

Gilt für:

Set(String, Object, CacheItemPolicy, String)

Fügt einen Cacheeintrag mithilfe eines Schlüssels und eines Werts und einer Entfernung in den Cache ein.

public override void Set(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit

Public Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)

Parameter

key: String

Ein eindeutiger Bezeichner für den einzufügenden Cacheeintrag.

value: Object

Die Daten für den Cacheeintrag.

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

Ausnahmen

ArgumentNullException

key ist null.

– oder –

value ist null

– oder –

Der Rückrufverweis, der an die Hilfsmethode in der UpdateCallback Eigenschaft übergeben wurde, lautet null.

ArgumentException

Es ist eine ungültige Kombination von Argumenten für den Cacheeintrag vorhanden. Dies tritt auf, wenn die folgenden Ablaufdetails für das Richtlinienobjekt für den Cacheeintrag festgelegt werden:
Wenn sowohl die absoluten als auch die gleitenden Ablaufwerte für CacheItemPolicy das Objekt auf andere Werte als die Standardwerte von InfiniteAbsoluteExpiration und NoSlidingExpiration. Dies liegt daran, dass die MemoryCache Klasse ablaufende Einträge nicht basierend auf einem absoluten und einem Gleitablauf unterstützt. Nur eine Ablaufeinstellung kann explizit festgelegt werden, wenn Sie die MemoryCache Klasse verwenden. Die andere Einstellung muss auf InfiniteAbsoluteExpiration oder NoSlidingExpiration.
Wenn sowohl der Entfernungsrückruf als auch der Updaterückruf für CacheItemPolicy die Klasse angegeben sind. Die MemoryCache Klasse unterstützt nur die Verwendung eines Rückruftyps pro Cacheeintrag.

ArgumentOutOfRangeException

Die SlidingExpiration Eigenschaft wird auf einen Wert festgelegt, der kleiner als Zeroist.

– oder –

Die SlidingExpiration Eigenschaft wird auf einen Wert festgelegt, der größer als ein Jahr ist.

– oder –

Die Priority Eigenschaft ist kein Wert der CacheItemPriority Enumeration.

NotSupportedException

regionName ist nicht null.

Hinweise

Wie andere Set Methodenüberladungen platziert die Set Methode immer einen Cachewert im Cache, unabhängig davon, ob bereits ein übereinstimmenden Eintrag vorhanden ist. Wenn der angegebene Eintrag nicht im Cache vorhanden ist, wird ein neuer Cacheeintrag eingefügt. Wenn der angegebene Eintrag vorhanden ist, wird er aktualisiert.

Gilt für:

Feedback

War diese Seite hilfreich?