Cache.Insert Método

Definição

Namespace:: System.Web.Caching

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Insere um item no Cache objeto. Use uma das versões desse método para substituir um item existente Cache com o mesmo key parâmetro.

Sobrecargas

Nome	Description
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Insere um objeto no Cache objeto com dependências, políticas de expiração e prioridade e um delegado que você pode usar para notificar seu aplicativo quando o item inserido for removido do `Cache`.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Insere um objeto no Cache objeto junto com dependências, políticas de expiração e um delegado que você pode usar para notificar o aplicativo antes que o item seja removido do cache.
Insert(String, Object, CacheDependency)	Insere um objeto no Cache que tem dependências de arquivo ou chave.
Insert(String, Object)	Insere um item no Cache objeto com uma chave de cache para referenciar sua localização, usando valores padrão fornecidos pela CacheItemPriority enumeração.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Insere um objeto nas Cache políticas com dependências e expiração.

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

Insere um objeto no Cache objeto com dependências, políticas de expiração e prioridade e um delegado que você pode usar para notificar seu aplicativo quando o item inserido for removido do 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)

Parâmetros

key: String

A chave de cache usada para referenciar o objeto.

value: Object

O objeto a ser inserido no cache.

dependencies: CacheDependency

As dependências de chave de arquivo ou cache para o item. Quando qualquer dependência é alterada, o objeto se torna inválido e é removido do cache. Se não houver dependências, esse parâmetro conterá null.

absoluteExpiration: DateTime

A hora em que o objeto inserido expira e é removido do cache. Para evitar possíveis problemas com a hora local, como alterações do horário padrão para o horário de verão, use UtcNow em vez desse Now valor de parâmetro. Se você estiver usando a expiração absoluta, o slidingExpiration parâmetro deverá ser NoSlidingExpiration.

slidingExpiration: TimeSpan

O intervalo entre a hora em que o objeto inserido foi acessado pela última vez e a hora em que esse objeto expira. Se esse valor for o equivalente a 20 minutos, o objeto expirará e será removido do cache 20 minutos depois de ter sido acessado pela última vez. Se você estiver usando a expiração deslizante, o absoluteExpiration parâmetro deverá ser NoAbsoluteExpiration.

priority: CacheItemPriority

O custo do objeto relativo a outros itens armazenados no cache, conforme expresso pela CacheItemPriority enumeração. Esse valor é usado pelo cache quando ele remove objetos; objetos com um custo menor são removidos do cache antes dos objetos com um custo mais alto.

onRemoveCallback: CacheItemRemovedCallback

Um delegado que, se fornecido, será chamado quando um objeto for removido do cache. Você pode usá-lo para notificar os aplicativos quando seus objetos são excluídos do cache.

Exceções

ArgumentNullException

O key parâmetro ou value o parâmetro é null.

ArgumentOutOfRangeException

Defina o slidingExpiration parâmetro como menor ou TimeSpan.Zero equivalente a mais de um ano.

ArgumentException

Os absoluteExpiration parâmetros e slidingExpiration os parâmetros são definidos para o item que você está tentando adicionar ao Cache.

Exemplos

O exemplo a seguir demonstra como atribuir um item de alta prioridade ao inseri-lo no objeto do Cache aplicativo.

Note

Para obter mais informações sobre como usar esse método com o CacheItemRemovedCallback delegado, consulte Como notificar um aplicativo quando um item é removido do cache.

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)

Comentários

Esse método substituirá um item existente Cache com o mesmo key parâmetro.

Você não pode definir os parâmetros e slidingExpiration os absoluteExpiration parâmetros. Se você pretende que o item de cache expire em um momento específico, defina o absoluteExpiration parâmetro para a hora específica e o slidingExpiration parâmetro como NoSlidingExpiration.

Se você pretende que o item de cache expire após um determinado período de tempo ter passado desde o último acesso ao item, defina o slidingExpiration parâmetro como o intervalo de expiração e o absoluteExpiration parâmetro como NoAbsoluteExpiration.

Confira também

Aplica-se a

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

Insere um objeto no Cache objeto junto com dependências, políticas de expiração e um delegado que você pode usar para notificar o aplicativo antes que o item seja removido do cache.

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)

Parâmetros

key: String

A chave de cache usada para fazer referência ao objeto.

value: Object

O objeto a ser inserido no cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

A hora em que o objeto inserido expira e é removido do cache. Para evitar possíveis problemas com a hora local, como alterações do horário padrão para o horário de verão, use UtcNow em vez desse valor de Now parâmetro. Se você estiver usando a expiração absoluta, o slidingExpiration parâmetro deverá ser definido como NoSlidingExpiration.

slidingExpiration: TimeSpan

O intervalo entre a hora em que o objeto armazenado em cache foi acessado pela última vez e a hora em que esse objeto expira. Se esse valor for o equivalente a 20 minutos, o objeto expirará e será removido do cache 20 minutos depois de ter sido acessado pela última vez. Se você estiver usando a expiração deslizante, o absoluteExpiration parâmetro deverá ser definido como NoAbsoluteExpiration.

onUpdateCallback: CacheItemUpdateCallback

Um delegado que será chamado antes que o objeto seja removido do cache. Você pode usá-lo para atualizar o item armazenado em cache e garantir que ele não seja removido do cache.

Exceções

ArgumentNullException

O keyparâmetro , valueou onUpdateCallback é null.

ArgumentOutOfRangeException

Defina o slidingExpiration parâmetro como menor ou TimeSpan.Zero equivalente a mais de um ano.

ArgumentException

Os absoluteExpiration parâmetros e slidingExpiration os parâmetros são definidos para o item que você está tentando adicionar ao Cache.

-ou-

O dependencies parâmetro é null, e o absoluteExpiration parâmetro é definido como NoAbsoluteExpiration, e o slidingExpiration parâmetro é definido como NoSlidingExpiration.

Comentários

O Insert método permite que você insira um novo item no cache e forneça um delegado chamado antes que o item seja removido do cache. No delegado, você pode atualizar o item armazenado em cache e, assim, impedir que ele seja removido do cache.

Esse método substituirá um item existente Cache com o mesmo key parâmetro.

Se você pretende que o item de cache expire após um período de tempo definido desde que o item foi acessado pela última vez, defina o slidingExpiration parâmetro como o intervalo de expiração e defina o absoluteExpiration parâmetro como NoAbsoluteExpiration.

Confira também

CacheItemUpdateCallback

Aplica-se a

Insert(String, Object, CacheDependency)

Insere um objeto no Cache que tem dependências de arquivo ou chave.

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)

Parâmetros

key: String

A chave de cache usada para identificar o item.

value: Object

O objeto a ser inserido no cache.

dependencies: CacheDependency

As dependências de chave de arquivo ou cache para o objeto inserido. Quando qualquer dependência é alterada, o objeto se torna inválido e é removido do cache. Se não houver dependências, esse parâmetro conterá null.

Exceções

ArgumentNullException

O key parâmetro ou value o parâmetro é null.

Exemplos

O exemplo a seguir demonstra como inserir um item no cache de um aplicativo com uma dependência de cache em um arquivo de configuração XML.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

Comentários

Esse método substituirá um item de cache existente cuja chave corresponde ao key parâmetro. O objeto adicionado ao cache usando essa sobrecarga do Insert método é inserido com uma prioridade de Default, um valor de expiração deslizante de NoSlidingExpiratione um valor de expiração absoluto de NoAbsoluteExpiration.

Confira também

CacheDependency

Aplica-se a

Insert(String, Object)

Insere um item no Cache objeto com uma chave de cache para referenciar sua localização, usando valores padrão fornecidos pela CacheItemPriority enumeração.

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)

Parâmetros

key: String

A chave de cache usada para referenciar o item.

value: Object

O objeto a ser inserido no cache.

Exceções

ArgumentNullException

O key parâmetro ou value o parâmetro é null.

Exemplos

O exemplo a seguir demonstra como inserir um item no cache de um aplicativo.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Comentários

Esse método substituirá um item de cache existente cuja chave corresponde ao key parâmetro. O objeto adicionado ao cache usando essa sobrecarga do Insert método é inserido sem dependências de arquivo ou cache, uma prioridade de Default, um valor de expiração deslizante e NoSlidingExpirationum valor de expiração absoluto de NoAbsoluteExpiration.

Confira também

Armazenar dados do aplicativo em cache

Aplica-se a

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

Insere um objeto nas Cache políticas com dependências e expiração.

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)

Parâmetros

key: String

A chave de cache usada para referenciar o objeto.

value: Object

O objeto a ser inserido no cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

O intervalo entre o tempo em que o objeto inserido é acessado pela última vez e a hora em que esse objeto expira. Se esse valor for o equivalente a 20 minutos, o objeto expirará e será removido do cache 20 minutos depois de ter sido acessado pela última vez. Se você estiver usando a expiração deslizante, o absoluteExpiration parâmetro deverá ser NoAbsoluteExpiration.

Exceções

ArgumentNullException

O key parâmetro ou value o parâmetro é null.

ArgumentOutOfRangeException

Defina o slidingExpiration parâmetro como menor ou TimeSpan.Zero equivalente a mais de um ano.

ArgumentException

Os absoluteExpiration parâmetros e slidingExpiration os parâmetros são definidos para o item que você está tentando adicionar ao Cache.

Exemplos

O exemplo a seguir demonstra como inserir um item no cache de um aplicativo com uma expiração absoluta.

Note

Como essa forma do método Insert dá suporte a dependências de cache, se o item não tiver dependências, você deverá declarar o parâmetro dependency como null (Nothing em Visual Basic) na lista delimitada por vírgulas de parâmetros.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

O exemplo a seguir demonstra como inserir um item no cache com uma expiração deslizante.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));

Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

Comentários

Esse método substituirá um item existente Cache com o mesmo key parâmetro.

Se o slidingExpiration parâmetro estiver definido como NoSlidingExpiration, a expiração deslizante será desabilitada. Se você definir o slidingExpiration parâmetro como maior que Zero, o absoluteExpiration parâmetro será definido como Now mais o valor contido no slidingExpiration parâmetro. Se o item for solicitado do cache antes da quantidade de tempo especificada pelo absoluteExpiration parâmetro, o item será colocado no cache novamente e absoluteExpiration será novamente definido como DateTime.Now mais o valor contido no slidingExpiration parâmetro. Se o item não for solicitado do cache antes da data no absoluteExpiration parâmetro, o item será removido do cache. O item adicionado ao cache usando essa sobrecarga do método de inserção é inserido com uma prioridade de Default.

Confira também

Aplica-se a

Comentários

Esta página foi útil?