MemoryCache.Set Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Caching

Zestaw:

System.Runtime.Caching.dll

Pakiet:

System.Runtime.Caching v9.0.0

Wstawia wpis pamięci podręcznej do pamięci podręcznej.

Przeciążenia

Set(CacheItem, CacheItemPolicy)	Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu CacheItem wystąpienia w celu podania klucza i wartości wpisu pamięci podręcznej.
Set(String, Object, DateTimeOffset, String)	Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu klucza i wartości oraz określa szczegóły wygaśnięcia na podstawie czasu.
Set(String, Object, CacheItemPolicy, String)	Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu klucza oraz wartości i eksmisji.

Uwagi

Jeśli określony wpis nie istnieje, zostanie utworzony. Jeśli określony wpis istnieje, zostanie zaktualizowany.

Set(CacheItem, CacheItemPolicy)

Źródło:

MemoryCache.cs

Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu CacheItem wystąpienia w celu podania klucza i wartości wpisu pamięci podręcznej.

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)

Parametry

item

CacheItem

Obiekt reprezentujący wpis pamięci podręcznej do wstawienia.

policy

CacheItemPolicy

Obiekt, który zawiera szczegóły eksmisji dla wpisu pamięci podręcznej. Ten obiekt zapewnia więcej opcji eksmisji niż proste bezwzględne wygaśnięcie.

Wyjątki

ArgumentNullException

item to null.

-lub-

Właściwość Key to null.

-lub-

Właściwość Value to null.

ArgumentException

Przekazano nieprawidłową kombinację argumentów dla wpisu pamięci podręcznej. Dzieje się tak, jeśli dla obiektu zasad dla wpisu pamięci podręcznej są ustawione następujące szczegóły wygasania:

• Jeśli zarówno bezwzględne, jak i przesuwane wartości CacheItemPolicy wygasania obiektu są ustawione na wartości inne niż wartości domyślne InfiniteAbsoluteExpiration i NoSlidingExpiration pola. Klasa MemoryCache nie może ustawić zasad wygasania na podstawie wygaśnięcia bezwzględnego i przesuwanego wygaśnięcia. W przypadku korzystania z MemoryCache klasy można jawnie ustawić tylko jedno ustawienie wygaśnięcia. Drugie ustawienie musi być ustawione na InfiniteAbsoluteExpiration wartość lub NoSlidingExpiration właściwość.

• Jeśli dla obiektu określono CacheItemPolicy wywołanie zwrotne usuwania i wywołanie zwrotne aktualizacji. Klasa MemoryCache obsługuje tylko jeden typ wywołania zwrotnego na wpis pamięci podręcznej.

ArgumentOutOfRangeException

Właściwość jest ustawiona SlidingExpiration na wartość mniejszą niż Zero.

-lub-

Właściwość jest ustawiona SlidingExpiration na wartość większą niż jeden rok.

-lub-

Wartość Priority nie jest wartością CacheItemPriority wyliczenia.

Uwagi

Podobnie jak inne Set przeciążenia metody, Set metoda zawsze umieszcza wartość pamięci podręcznej w pamięci podręcznej, niezależnie od tego, czy wpis już istnieje, który ma ten sam klucz. Jeśli określony wpis nie istnieje w pamięci podręcznej, zostanie wstawiony nowy wpis pamięci podręcznej. Jeśli określony wpis już istnieje, jego wartość zostanie zaktualizowana.

Set(String, Object, DateTimeOffset, String)

Źródło:

MemoryCache.cs

Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu klucza i wartości oraz określa szczegóły wygaśnięcia na podstawie czasu.

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)

Parametry

key

String

Unikatowy identyfikator wpisu pamięci podręcznej do wstawienia.

value

Object

Dane wpisu pamięci podręcznej.

absoluteExpiration

DateTimeOffset

Stała data i godzina wygaśnięcia wpisu pamięci podręcznej.

regionName

String

Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej. Nie przekazuj wartości dla tego parametru. Ten parametr jest null domyślnie, ponieważ MemoryCache klasa nie implementuje regionów.

Wyjątki

NotSupportedException

regionName nie nulljest .

ArgumentNullException

key to null.

-lub-

Value to null.

ArgumentException

• Przekazano nieprawidłową kombinację argumentów dla wpisu pamięci podręcznej. Dzieje się tak, jeśli dla obiektu zasad dla wpisu pamięci podręcznej są ustawione następujące szczegóły wygasania:

• Jeśli zarówno bezwzględne, jak i przesuwane wartości wygasania obiektu CacheItemPolicy są ustawione na wartości inne niż wartości domyślne InfiniteAbsoluteExpiration i NoSlidingExpiration. Dzieje się tak, ponieważ MemoryCache klasa nie obsługuje wygasających wpisów na podstawie bezwzględnego i przesuwanego wygaśnięcia. W przypadku korzystania z MemoryCache klasy można jawnie ustawić tylko jedno ustawienie wygaśnięcia. Drugie ustawienie musi być ustawione na InfiniteAbsoluteExpiration lub NoSlidingExpiration.

• Jeśli w obiekcie określono CacheItemPolicy wywołanie zwrotne usuwania i wywołanie zwrotne aktualizacji. Klasa MemoryCache obsługuje tylko jeden typ wywołania zwrotnego na wpis pamięci podręcznej.

ArgumentOutOfRangeException

Właściwość jest ustawiona SlidingExpiration na wartość mniejszą niż Zero.

-lub-

Właściwość jest ustawiona SlidingExpiration na wartość większą niż jeden rok.

-lub-

• Właściwość Priority nie jest wartością CacheItemPriority wyliczenia.

Uwagi

Podobnie jak inne Set przeciążenia metody, Set metoda zawsze umieszcza wartość pamięci podręcznej w pamięci podręcznej, niezależnie od tego, czy wpis już istnieje z tym samym kluczem. Jeśli określony wpis nie istnieje, zostanie wstawiony nowy wpis pamięci podręcznej. Jeśli określony wpis istnieje, zostanie zaktualizowany.

Parametr absoluteExpiration wskazuje, kiedy należy usunąć wpis z pamięci podręcznej.

Usunięcie wpisu wyzwala wszystkie skojarzone monitory zmian. Jeśli usunięty element został skojarzony z obiektem lub CacheItemRemovedCallback obiektemCacheItemUpdateCallback, przyczyna usunięcia przekazywana do wywołań zwrotnych jest zawarta Removed we właściwości .

Set(String, Object, CacheItemPolicy, String)

Źródło:

MemoryCache.cs

Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu klucza oraz wartości i eksmisji.

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)

Parametry

key

String

Unikatowy identyfikator wpisu pamięci podręcznej do wstawienia.

value

Object

Dane wpisu pamięci podręcznej.

policy

CacheItemPolicy

Obiekt, który zawiera szczegóły eksmisji dla wpisu pamięci podręcznej. Ten obiekt zapewnia więcej opcji eksmisji niż proste bezwzględne wygaśnięcie.

regionName

String

Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej. Nie przekazuj wartości dla tego parametru. Ten parametr jest null domyślnie, ponieważ MemoryCache klasa nie implementuje regionów.

Wyjątki

ArgumentNullException

key to null.

-lub-

value to null

-lub-

Odwołanie wywołania zwrotnego przekazane do metody pomocniczej UpdateCallback we właściwości to null.

ArgumentException

• Istnieje nieprawidłowa kombinacja argumentów dla wpisu pamięci podręcznej. Dzieje się tak, jeśli dla obiektu zasad dla wpisu pamięci podręcznej są ustawione następujące szczegóły wygasania:

• Jeśli zarówno bezwzględne, jak i przesuwane wartości wygasania obiektu CacheItemPolicy są ustawione na wartości inne niż wartości domyślne InfiniteAbsoluteExpiration i NoSlidingExpiration. Wynika to z tego, że MemoryCache klasa nie obsługuje wygasających wpisów na podstawie bezwzględnego i przesuwanego wygaśnięcia. W przypadku korzystania z MemoryCache klasy można jawnie ustawić tylko jedno ustawienie wygaśnięcia. Drugie ustawienie musi być ustawione na InfiniteAbsoluteExpiration lub NoSlidingExpiration.

• Jeśli w klasie określono CacheItemPolicy wywołanie zwrotne usuwania i wywołanie zwrotne aktualizacji. Klasa MemoryCache obsługuje tylko jeden typ wywołania zwrotnego na wpis pamięci podręcznej.

ArgumentOutOfRangeException

Właściwość jest ustawiona SlidingExpiration na wartość mniejszą niż Zero.

-lub-

Właściwość jest ustawiona SlidingExpiration na wartość większą niż jeden rok.

-lub-

Właściwość Priority nie jest wartością CacheItemPriority wyliczenia.

NotSupportedException

regionName nie nulljest .

Uwagi

Podobnie jak inne Set przeciążenia metody, Set metoda zawsze umieszcza wartość pamięci podręcznej w pamięci podręcznej, niezależnie od tego, czy pasujący wpis już istnieje. Jeśli określony wpis nie istnieje w pamięci podręcznej, zostanie wstawiony nowy wpis pamięci podręcznej. Jeśli określony wpis istnieje, zostanie zaktualizowany.

Usunięcie wpisu wyzwala wszystkie skojarzone monitory zmian. Jeśli usunięty element został skojarzony z obiektem lub CacheItemRemovedCallback obiektemCacheItemUpdateCallback, przyczyna usunięcia przekazywana do wywołań zwrotnych jest zawarta Removed we właściwości .