Cache.Insert Método

Definição

Namespace:

System.Web.Caching

Assembly:

System.Web.dll

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 Cache.
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 -> 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 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

ArgumentNullException

O parâmetro key ou value é null.

ArgumentOutOfRangeException

Você define o parâmetro slidingExpiration para menos de TimeSpan.Zero ou o equivalente de mais de um ano.

ArgumentException

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

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 -> 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 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

ArgumentNullException

O parâmetro key, value ou onUpdateCallback é null.

ArgumentOutOfRangeException

Você define o parâmetro slidingExpiration para menos de TimeSpan.Zero ou o equivalente de mais de um ano.

ArgumentException

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

• CacheItemUpdateCallback

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 -> 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 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

ArgumentNullException

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

• CacheDependency

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 -> 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 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

• Armazenando dados do aplicativo em cache

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 -> 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 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

ArgumentNullException

O parâmetro key ou value é null.

ArgumentOutOfRangeException

Você define o parâmetro slidingExpiration para menos de TimeSpan.Zero ou o equivalente de mais de um ano.

ArgumentException

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

• DateTime
• TimeSpan
• Armazenando dados do aplicativo em cache