Cache.Insert Metoda

Definicja

Przestrzeń nazw:

System.Web.Caching

Zestaw:

System.Web.dll

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

ArgumentNullException

Parametr key or value to null.

ArgumentOutOfRangeException

Należy ustawić slidingExpiration parametr na wartość mniejszą niż TimeSpan.Zero lub równoważną więcej niż jeden rok.

ArgumentException

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ż

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Buforowanie danych aplikacji

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

ArgumentNullException

Parametr key, valuelub onUpdateCallback ma wartość null.

ArgumentOutOfRangeException

Należy ustawić slidingExpiration parametr na wartość mniejszą niż TimeSpan.Zero lub równoważną więcej niż jeden rok.

ArgumentException

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ż

• CacheItemUpdateCallback

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

ArgumentNullException

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ż

• CacheDependency

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

ArgumentNullException

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ż

• Buforowanie danych aplikacji

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

ArgumentNullException

Parametr key or value to null.

ArgumentOutOfRangeException

Należy ustawić slidingExpiration parametr na wartość mniejszą niż TimeSpan.Zero lub równoważną więcej niż jeden rok.

ArgumentException

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ż

• DateTime
• TimeSpan
• Buforowanie danych aplikacji