Cache.Insert Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wstawia element do Cache obiektu. Użyj jednej z wersji tej metody, aby zastąpić istniejący Cache element tym samym key parametrem.
Przeciążenia
| Nazwa | Opis |
|---|---|
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Wstawia obiekt do Cache obiektu z zasadami zależności, wygasania i priorytetu oraz delegatem, którego można użyć do powiadamiania aplikacji o usunięciu wstawionego elementu z obiektu |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Wstawia obiekt do Cache obiektu wraz z zależnościami, zasadami wygasania i pełnomocnikiem, którego można użyć do powiadamiania aplikacji przed usunięciem elementu z pamięci podręcznej. |
| Insert(String, Object, CacheDependency) |
Wstawia obiekt do Cache pliku lub zależności klucza. |
| Insert(String, Object) |
Wstawia element do Cache obiektu z kluczem pamięci podręcznej w celu odwołania się do jego lokalizacji przy użyciu wartości domyślnych dostarczonych CacheItemPriority przez wyliczenie. |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan) |
Wstawia obiekt do obiektu Cache z zasadami zależności i wygasania. |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Wstawia obiekt do Cache obiektu z zasadami zależności, wygasania i priorytetu oraz delegatem, którego można użyć do powiadamiania aplikacji o usunięciu wstawionego elementu z obiektu Cache.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)Parametry
- key
- String
Klucz pamięci podręcznej używany do odwołowania się do obiektu.
- value
- Object
Obiekt, który ma zostać wstawiony w pamięci podręcznej.
- dependencies
- CacheDependency
Zależności klucza pliku lub pamięci podręcznej dla elementu. Gdy jakakolwiek zależność ulegnie zmianie, obiekt stanie się nieprawidłowy i zostanie usunięty z pamięci podręcznej. Jeśli nie ma żadnych zależności, ten parametr zawiera nullwartość .
- absoluteExpiration
- DateTime
Czas wygaśnięcia wstawionego obiektu i jest usuwany z pamięci podręcznej. Aby uniknąć możliwych problemów z czasem lokalnym, takich jak zmiany z czasu standardowego na czas letni, użyj UtcNow zamiast Now dla tej wartości parametru. Jeśli używasz bezwzględnego wygaśnięcia, slidingExpiration parametr musi mieć wartość NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interwał między czasem ostatniego dostępu do wstawionego obiektu a czasem wygaśnięcia tego obiektu. Jeśli ta wartość jest odpowiednikiem 20 minut, obiekt wygaśnie i zostanie usunięty z pamięci podręcznej 20 minut po ostatnim dokonaniu dostępu. Jeśli używasz przesuwania wygasania, absoluteExpiration parametr musi mieć wartość NoAbsoluteExpiration.
- priority
- CacheItemPriority
Koszt obiektu względem innych elementów przechowywanych w pamięci podręcznej, wyrażony CacheItemPriority przez wyliczenie. Ta wartość jest używana przez pamięć podręczną podczas eksmitowania obiektów; obiekty o niższych kosztach są usuwane z pamięci podręcznej przed obiektami o wyższych kosztach.
- onRemoveCallback
- CacheItemRemovedCallback
Pełnomocnik, który, jeśli zostanie podany, zostanie wywołany, gdy obiekt zostanie usunięty z pamięci podręcznej. Służy to do powiadamiania aplikacji o usunięciu ich obiektów z pamięci podręcznej.
Wyjątki
Parametr key or value to null.
Dla parametru slidingExpiration należy ustawić wartość mniejszą niż TimeSpan.Zero lub równoważną więcej niż jeden rok.
Parametry absoluteExpiration i slidingExpiration są ustawione dla elementu, który próbujesz dodać do elementu Cache.
Przykłady
W poniższym przykładzie pokazano, jak przypisać element o wysokim priorytetzie podczas wstawiania go do obiektu aplikacji Cache .
Note
Aby uzyskać więcej informacji na temat używania tej metody z pełnomocnikiem CacheItemRemovedCallback , zobacz Jak: powiadamianie aplikacji o usunięciu elementu z pamięci podręcznej.
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove)
Uwagi
Ta metoda zastąpi istniejący Cache element tym samym key parametrem.
Nie można ustawić parametrów absoluteExpiration i .slidingExpiration Jeśli zamierzasz, aby element pamięci podręcznej wygasał w określonym czasie, należy ustawić absoluteExpiration parametr na określony czas, a parametr na slidingExpirationNoSlidingExpiration wartość .
Jeśli element pamięci podręcznej wygaśnie po upływie określonego czasu od ostatniego dostępu do elementu, należy ustawić slidingExpiration parametr na interwał wygaśnięcia, a absoluteExpiration parametr na NoAbsoluteExpirationwartość .
Zobacz też
Dotyczy
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Wstawia obiekt do Cache obiektu wraz z zależnościami, zasadami wygasania i pełnomocnikiem, którego można użyć do powiadamiania aplikacji przed usunięciem elementu z pamięci podręcznej.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)Parametry
- key
- String
Klucz pamięci podręcznej używany do odwołowania się do obiektu.
- value
- Object
Obiekt do wstawienia do pamięci podręcznej.
- dependencies
- CacheDependency
Zależności klucza pliku lub pamięci podręcznej dla elementu. Gdy jakakolwiek zależność ulegnie zmianie, obiekt stanie się nieprawidłowy i zostanie usunięty z pamięci podręcznej. Jeśli nie ma żadnych zależności, ten parametr zawiera nullwartość .
- absoluteExpiration
- DateTime
Czas wygaśnięcia wstawionego obiektu i jest usuwany z pamięci podręcznej. Aby uniknąć możliwych problemów z czasem lokalnym, takich jak zmiany z czasu standardowego na czas letni, użyj UtcNow zamiast dla tej wartości parametru Now . Jeśli używasz wygaśnięcia bezwzględnego, slidingExpiration parametr musi być ustawiony na NoSlidingExpirationwartość .
- slidingExpiration
- TimeSpan
Interwał między czasem ostatniego uzyskania dostępu do buforowanego obiektu a czasem wygaśnięcia tego obiektu. Jeśli ta wartość jest odpowiednikiem 20 minut, obiekt wygaśnie i zostanie usunięty z pamięci podręcznej 20 minut po ostatnim dokonaniu dostępu. Jeśli używasz przesuwania wygasania, absoluteExpiration parametr musi być ustawiony na NoAbsoluteExpirationwartość .
- onUpdateCallback
- CacheItemUpdateCallback
Delegat, który zostanie wywołany przed usunięciem obiektu z pamięci podręcznej. Można go użyć do zaktualizowania buforowanego elementu i upewnienia się, że nie został usunięty z pamięci podręcznej.
Wyjątki
Parametr key, valuelub onUpdateCallback ma wartość null.
Dla parametru slidingExpiration należy ustawić wartość mniejszą niż TimeSpan.Zero lub równoważną więcej niż jeden rok.
Parametry absoluteExpiration i slidingExpiration są ustawione dla elementu, który próbujesz dodać do elementu Cache.
— lub —
Parametr dependencies ma nullwartość , a absoluteExpiration parametr jest ustawiony na NoAbsoluteExpirationwartość , a slidingExpiration parametr jest ustawiony na NoSlidingExpirationwartość .
Uwagi
Metoda Insert umożliwia wstawienie nowego elementu w pamięci podręcznej i podanie delegata wywoływanego przed usunięciem elementu z pamięci podręcznej. W delegacie można zaktualizować buforowany element i uniemożliwić jego usunięcie z pamięci podręcznej.
Ta metoda zastąpi istniejący Cache element tym samym key parametrem.
Nie można ustawić parametrów absoluteExpiration i .slidingExpiration Jeśli zamierzasz, aby element pamięci podręcznej wygasał w określonym czasie, należy ustawić absoluteExpiration parametr na określony czas, a parametr na slidingExpirationNoSlidingExpiration wartość .
Jeśli zamierzasz, aby element pamięci podręcznej wygasał po upływie określonego okresu czasu od czasu ostatniego uzyskania dostępu do elementu, należy ustawić slidingExpiration parametr na interwał wygaśnięcia i ustawić absoluteExpiration parametr na NoAbsoluteExpirationwartość .
Zobacz też
Dotyczy
Insert(String, Object, CacheDependency)
Wstawia obiekt do Cache pliku lub zależności klucza.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies);member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency)Parametry
- key
- String
Klucz pamięci podręcznej używany do identyfikowania elementu.
- value
- Object
Obiekt, który ma zostać wstawiony w pamięci podręcznej.
- dependencies
- CacheDependency
Zależności klucza pliku lub pamięci podręcznej dla wstawionego obiektu. Gdy jakakolwiek zależność ulegnie zmianie, obiekt stanie się nieprawidłowy i zostanie usunięty z pamięci podręcznej. Jeśli nie ma żadnych zależności, ten parametr zawiera nullwartość .
Wyjątki
Parametr key or value to null.
Przykłady
W poniższym przykładzie pokazano, jak wstawić element do pamięci podręcznej aplikacji z zależnością pamięci podręcznej od pliku konfiguracji XML.
Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));
Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))
Uwagi
Ta metoda zastąpi istniejący element pamięci podręcznej, którego klucz pasuje do parametru key . Obiekt dodany do pamięci podręcznej przy użyciu tego przeciążenia Insert metody jest wstawiany z priorytetem Default, przesuwaną wartością wygaśnięcia i bezwzględną wartością NoSlidingExpirationNoAbsoluteExpirationwygaśnięcia .
Zobacz też
Dotyczy
Insert(String, Object)
Wstawia element do Cache obiektu z kluczem pamięci podręcznej w celu odwołania się do jego lokalizacji przy użyciu wartości domyślnych dostarczonych CacheItemPriority przez wyliczenie.
public:
void Insert(System::String ^ key, System::Object ^ value);public void Insert(string key, object value);member this.Insert : string * obj -> unitPublic Sub Insert (key As String, value As Object)Parametry
- key
- String
Klucz pamięci podręcznej używany do odwołowania się do elementu.
- value
- Object
Obiekt, który ma zostać wstawiony do pamięci podręcznej.
Wyjątki
Parametr key or value to null.
Przykłady
W poniższym przykładzie pokazano, jak wstawić element do pamięci podręcznej aplikacji.
Cache.Insert("DSN", connectionString);
Cache.Insert("DSN", connectionString)
Uwagi
Ta metoda zastąpi istniejący element pamięci podręcznej, którego klucz pasuje do parametru key . Obiekt dodany do pamięci podręcznej przy użyciu tego przeciążenia Insert metody jest wstawiany bez zależności pliku lub pamięci podręcznej, priorytet wartości Default, przesuwanej wartości wygaśnięcia i bezwzględnej wartości NoSlidingExpirationNoAbsoluteExpirationwygaśnięcia .
Zobacz też
Dotyczy
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Wstawia obiekt do obiektu Cache z zasadami zależności i wygasania.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)Parametry
- key
- String
Klucz pamięci podręcznej używany do odwołowania się do obiektu.
- value
- Object
Obiekt, który ma zostać wstawiony w pamięci podręcznej.
- dependencies
- CacheDependency
Zależności klucza pliku lub pamięci podręcznej dla wstawionego obiektu. Gdy jakakolwiek zależność ulegnie zmianie, obiekt stanie się nieprawidłowy i zostanie usunięty z pamięci podręcznej. Jeśli nie ma żadnych zależności, ten parametr zawiera nullwartość .
- absoluteExpiration
- DateTime
Czas wygaśnięcia wstawionego obiektu i jest usuwany z pamięci podręcznej. Aby uniknąć możliwych problemów z czasem lokalnym, takich jak zmiany z czasu standardowego na czas letni, użyj UtcNow zamiast Now dla tej wartości parametru. Jeśli używasz bezwzględnego wygaśnięcia, slidingExpiration parametr musi mieć wartość NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interwał między czasem ostatniego dostępu do wstawionego obiektu a czasem wygaśnięcia tego obiektu. Jeśli ta wartość jest odpowiednikiem 20 minut, obiekt wygaśnie i zostanie usunięty z pamięci podręcznej 20 minut po ostatnim dokonaniu dostępu. Jeśli używasz przesuwania wygasania, absoluteExpiration parametr musi mieć wartość NoAbsoluteExpiration.
Wyjątki
Parametr key or value to null.
Dla parametru slidingExpiration należy ustawić wartość mniejszą niż TimeSpan.Zero lub równoważną więcej niż jeden rok.
Parametry absoluteExpiration i slidingExpiration są ustawione dla elementu, który próbujesz dodać do elementu Cache.
Przykłady
W poniższym przykładzie pokazano, jak wstawić element do pamięci podręcznej aplikacji z bezwzględnym wygaśnięciem.
Note
Ponieważ ta forma metody Insert obsługuje zależności pamięci podręcznej, jeśli element nie ma zależności, należy zadeklarować parametr dependency jako null (Nothing w Visual Basic) na liście parametrów rozdzielonych przecinkami.
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)
W poniższym przykładzie pokazano, jak wstawić element do pamięci podręcznej z przesuwanym wygaśnięciem.
Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));
Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))
Uwagi
Ta metoda zastąpi istniejący Cache element tym samym key parametrem.
slidingExpiration Jeśli parametr jest ustawiony na NoSlidingExpirationwartość , wygasanie przesuwane jest wyłączone. Jeśli ustawisz slidingExpiration parametr na wartość większą niż Zero, absoluteExpiration parametr zostanie ustawiony na Now wartość plus wartość zawartą w parametrze slidingExpiration . Jeśli element jest żądany z pamięci podręcznej przed upływem czasu określonego przez absoluteExpiration parametr, element zostanie ponownie umieszczony w pamięci podręcznej i absoluteExpiration zostanie ponownie ustawiony na DateTime.Now plus wartość zawartą w parametrze slidingExpiration . Jeśli element nie jest żądany z pamięci podręcznej przed datą w parametrze absoluteExpiration , element zostanie usunięty z pamięci podręcznej. Element dodany do pamięci podręcznej przy użyciu tego przeciążenia metody insert jest wstawiany z priorytetem Default.
