Cache.Insert Método
Definição
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 objeto Cache. Use uma das versões deste método para substituir um item Cache existente pelo mesmo parâmetro key.
Sobrecargas
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Insere um objeto no objeto Cache com dependências, políticas de expiração e de prioridade, além de um delegado que você pode usar para notificar o aplicativo quando o item inserido é removido do |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Insere um objeto no objeto Cache junto com as dependências, políticas de expiração e um delegado que pode ser usado 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 de chave. |
| Insert(String, Object) |
Insere um item no objeto Cache com uma chave de cache para fazer referência à sua localização, usando os valores padrão fornecidos pela enumeração CacheItemPriority. |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan) |
Insere um objeto no Cache com dependências e políticas de vencimento. |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Insere um objeto no objeto Cache com dependências, políticas de expiração e de prioridade, além de um delegado que você pode usar para notificar o aplicativo quando o item inserido é 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 -> unitPublic 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 fazer referência ao objeto.
- value
- Object
O objeto a ser inserido no cache.
- dependencies
- CacheDependency
As dependências de chave de cache ou de arquivo do item. Quando uma dependência é alterada, o objeto se torna inválido e é removido do cache. Se não houver nenhuma dependência, este 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 de Now para este valor de parâmetro. Se você estiver usando uma expiração absoluta, o parâmetro slidingExpiration 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 de 20 minutos, o objeto expirará e será removido do cache 20 minutos após seu último acesso. Se você estiver usando a expiração deslizante, o parâmetro absoluteExpiration deverá ser NoAbsoluteExpiration.
- priority
- CacheItemPriority
O custo do objeto em relação a outros itens armazenados em cache, expresso pela enumeração CacheItemPriority. O cache usa esse valor quando remove objetos. Os objetos com um custo mais baixo são removidos do cache antes dos objetos com custo mais alto.
- onRemoveCallback
- CacheItemRemovedCallback
Um delegado que, caso seja fornecido, será chamado quando um objeto for removido do cache. Use isso para notificar os aplicativos quando seus objetos são excluídos do cache.
Exceções
O parâmetro key ou value é null.
Você define o parâmetro slidingExpiration para menos de TimeSpan.Zero ou o equivalente de mais de um ano.
Os parâmetros absoluteExpiration e slidingExpiration 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.
Observação
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 pelo mesmo key parâmetro.
Não é possível definir os absoluteExpiration parâmetros e slidingExpiration . Se você pretende que o item de cache expire em um momento específico, defina o absoluteExpiration parâmetro como o horário específico e o slidingExpiration parâmetro como NoSlidingExpiration.
Se você pretende que o item de cache expire depois que um determinado período de tempo tiver 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
- DateTime
- TimeSpan
- CacheItemPriority
- CacheItemRemovedCallback
- Armazenando dados do aplicativo em cache
Aplica-se a
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Insere um objeto no objeto Cache junto com as dependências, políticas de expiração e um delegado que pode ser usado 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 -> unitPublic 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 referenciar o objeto.
- value
- Object
O objeto a ser inserido no cache.
- dependencies
- CacheDependency
As dependências de chave de cache ou de arquivo do item. Quando uma dependência é alterada, o objeto se torna inválido e é removido do cache. Se não houver nenhuma dependência, este 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 de Now para esse valor de parâmetro. Se você estiver usando uma expiração absoluta, o parâmetro slidingExpiration 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 de 20 minutos, o objeto expirará e será removido do cache 20 minutos após seu último acesso. Se você estiver usando a expiração deslizante, o parâmetro absoluteExpiration deverá ser definido como NoAbsoluteExpiration.
- onUpdateCallback
- CacheItemUpdateCallback
Um delegado que será chamado antes de o objeto ser removido do cache. É possível usar isso para atualizar o item armazenado em cache e para certificar-se de que ele não foi removido do cache.
Exceções
O parâmetro key, value ou onUpdateCallback é null.
Você define o parâmetro slidingExpiration para menos de TimeSpan.Zero ou o equivalente de mais de um ano.
Os parâmetros absoluteExpiration e slidingExpiration são definidos para o item que você está tentando adicionar ao Cache.
- ou -
O parâmetro dependencies é null, e o parâmetro absoluteExpiration é definido como NoAbsoluteExpiration, e o parâmetro slidingExpiration é definido como NoSlidingExpiration.
Comentários
O Insert método permite inserir um novo item no cache e fornecer um delegado que é 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 pelo mesmo key parâmetro.
Não é possível definir os absoluteExpiration parâmetros e slidingExpiration . Se você pretende que o item de cache expire em um momento específico, defina o absoluteExpiration parâmetro como o horário específico e o slidingExpiration parâmetro como NoSlidingExpiration.
Se você pretende que o item de cache expire após um período 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
Aplica-se a
Insert(String, Object, CacheDependency)
Insere um objeto no Cache que tem dependências de arquivo ou de 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 -> unitPublic 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 arquivo ou de cache do objeto inserido. Quando uma dependência é alterada, o objeto se torna inválido e é removido do cache. Se não houver nenhuma dependência, este parâmetro conterá null.
Exceções
O parâmetro key ou value é 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 , um valor de Defaultexpiração deslizante de NoSlidingExpiratione um valor de expiração absoluto de NoAbsoluteExpiration.
Confira também
Aplica-se a
Insert(String, Object)
Insere um item no objeto Cache com uma chave de cache para fazer referência à sua localização, usando os valores padrão fornecidos pela enumeração CacheItemPriority.
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)Parâmetros
- key
- String
A chave de cache usada para referenciar o item.
- value
- Object
O objeto a ser inserido no cache.
Exceções
O parâmetro key ou value é 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 de NoSlidingExpiratione um valor de expiração absoluto de NoAbsoluteExpiration.
Confira também
Aplica-se a
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Insere um objeto no Cache com dependências e políticas de vencimento.
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)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
As dependências de arquivo ou de cache do objeto inserido. Quando uma dependência é alterada, o objeto se torna inválido e é removido do cache. Se não houver nenhuma dependência, este 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 de Now para este valor de parâmetro. Se você estiver usando uma expiração absoluta, o parâmetro slidingExpiration 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 de 20 minutos, o objeto expirará e será removido do cache 20 minutos após seu último acesso. Se você estiver usando a expiração deslizante, o parâmetro absoluteExpiration deverá ser NoAbsoluteExpiration.
Exceções
O parâmetro key ou value é null.
Você define o parâmetro slidingExpiration para menos de TimeSpan.Zero ou o equivalente de mais de um ano.
Os parâmetros absoluteExpiration e slidingExpiration 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.
Observação
Como essa forma do método dá suporte a Insert dependências de cache, se o item não tiver dependências, você deverá declarar o dependency parâmetro como null (Nothing no 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 pelo mesmo key parâmetro.
Se o slidingExpiration parâmetro for definido NoSlidingExpirationcomo , 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 do tempo especificado 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 insert é inserido com uma prioridade de Default.
Confira também
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de