Udostępnij za pośrednictwem


Cache.Insert Metoda

Definicja

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

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Wstawia obiekt do Cache obiektu z zależnościami, zasadami wygasania i priorytetu oraz delegatem, którego można użyć do powiadamiania aplikacji o usunięciu wstawionego elementu z obiektu Cache.

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 obiektu, który ma zależności pliku lub 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 zależnościami, zasadami 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 -> unit
Public 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ływanie 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 dowolna 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, w którym wstawiony obiekt wygasa 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 do niego 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

Delegat, 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.

Należy ustawić slidingExpiration parametr na 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 .

Uwaga

Aby uzyskać więcej informacji na temat używania tej metody z delegatem 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 NoSlidingExpirationslidingExpiration .

Jeśli element pamięci podręcznej wygaśnie po upływie pewnego czasu od ostatniego dostępu do elementu, należy ustawić slidingExpiration parametr na interwał wygaśnięcia, a parametr na absoluteExpirationNoAbsoluteExpirationwartość .

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 -> unit
Public 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ływanie 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 dowolna 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, w którym wstawiony obiekt wygasa 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 bezwzględnego wygaśnięcia, 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 do niego 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.

Należy ustawić slidingExpiration parametr na 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, który jest wywoływany przed usunięciem elementu z pamięci podręcznej. W obiekcie delegowanym można zaktualizować buforowany element i zapobiec jego usunięciu 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 NoSlidingExpirationslidingExpiration .

Jeśli zamierzasz, aby element pamięci podręcznej wygasał po określonym czasie od czasu ostatniego uzyskania dostępu do elementu, należy ustawić slidingExpiration parametr na interwał wygaśnięcia i ustawić parametr na absoluteExpirationNoAbsoluteExpiration.

Zobacz też

Dotyczy

Insert(String, Object, CacheDependency)

Wstawia obiekt do Cache obiektu, który ma zależności pliku lub 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 -> unit
Public 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 dowolna 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 o wartości Default, przesuwanej wartości wygaśnięcia i bezwzględnej 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 -> unit
Public Sub Insert (key As String, value As Object)

Parametry

key
String

Klucz pamięci podręcznej używany do odwoływanie 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 Default, przesuwana wartość NoSlidingExpirationwygaśnięcia i bezwzględna wartość NoAbsoluteExpirationwygaś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 -> unit
Public 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ływanie 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 dowolna 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, w którym wstawiony obiekt wygasa 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 do niego dostępu. Jeśli używasz przesuwania wygasania, absoluteExpiration parametr musi mieć wartość NoAbsoluteExpiration.

Wyjątki

Parametr key or value to null.

Należy ustawić slidingExpiration parametr na 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.

Uwaga

Ponieważ ta forma Insert metody obsługuje zależności pamięci podręcznej, jeśli element nie ma zależności, należy zadeklarować dependency parametr 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 większą niż Zero, absoluteExpiration parametr jest ustawiony na Now plus wartość zawartą w parametrze slidingExpiration . Jeśli element jest żądany z pamięci podręcznej przed upływem czasu określonego absoluteExpiration przez 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.

Zobacz też

Dotyczy