Cache.Insert Método

Definição

Espaço de Nomes:: System.Web.Caching

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	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 pode usar para notificar a sua aplicação quando o item inserido for removido do `Cache`arquivo .
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Insere um objeto no Cache objeto juntamente com dependências, políticas de expiração e um delegado que pode usar para notificar a aplicação antes de o item ser removido da cache.
Insert(String, Object, CacheDependency)	Insere um objeto no Cache que tem dependências de ficheiro ou chave.
Insert(String, Object)	Insere um item no Cache objeto com uma chave de cache para referenciar a sua localização, usando os valores predefinidos fornecidos pela CacheItemPriority enumeração.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Insere um objeto no Cache com dependências e políticas de 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 pode usar para notificar a sua aplicação quando o item inserido for removido do Cachearquivo .

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 inserir na cache.

dependencies: CacheDependency

As dependências do ficheiro ou da chave de cache para o item. Quando qualquer dependência muda, o objeto torna-se inválido e é removido da cache. Se não existirem dependências, este parâmetro contém null.

absoluteExpiration: DateTime

O momento em que o objeto inserido expira e é removido da 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 estiver a usar expiração absoluta, o slidingExpiration parâmetro deve ser NoSlidingExpiration.

slidingExpiration: TimeSpan

O intervalo entre o momento em que o objeto inserido foi acedido pela última vez e o momento em que esse objeto expira. Se este valor for equivalente a 20 minutos, o objeto expirará e será removido da cache 20 minutos após o seu último acesso. Se estiver a usar expiração deslizante, o absoluteExpiration parâmetro deve ser NoAbsoluteExpiration.

priority: CacheItemPriority

O custo do objeto em relação a outros itens armazenados na cache, conforme expresso pela CacheItemPriority enumeração. Este valor é usado pela cache quando esta expulsa objetos; os objetos com custo mais baixo são removidos do cache antes dos objetos com custo superior.

onRemoveCallback: CacheItemRemovedCallback

Um delegado que, se for, será chamado quando um objeto for removido da cache. Pode usar isto para notificar as aplicações quando os seus objetos são eliminados da cache.

Exceções

ArgumentNullException

O key parâmetro ou value é null.

ArgumentOutOfRangeException

Define o slidingExpiration parâmetro para menos ou TimeSpan.Zero equivalente a mais de um ano.

ArgumentException

Os absoluteExpiration parâmetros e slidingExpiration estão ambos definidos para o item que está a tentar adicionar ao Cache.

Exemplos

O exemplo seguinte demonstra como atribuir alta prioridade a um item quando o insere no objeto da Cache sua aplicação.

Note

Para mais informações sobre como usar este método com o CacheItemRemovedCallback delegado, veja Como: Notificar uma Aplicação Quando um Item É Removido da 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)

Observações

Este método irá sobrescrever um item existente Cache com o mesmo key parâmetro.

Não podes definir ambos os absoluteExpiration parâmetros e.slidingExpiration Se pretende que o item da cache expire numa hora específica, define o absoluteExpiration parâmetro para o tempo específico e o slidingExpiration parâmetro para NoSlidingExpiration.

Se pretende que o item de cache expire após um certo período de tempo desde o último acesso ao item, define o slidingExpiration parâmetro para o intervalo de expiração e o absoluteExpiration parâmetro para NoAbsoluteExpiration.

Ver também

Aplica-se a

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

Insere um objeto no Cache objeto juntamente com dependências, políticas de expiração e um delegado que pode usar para notificar a aplicação antes de o item ser removido da 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 inserir na cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

O intervalo entre o momento em que o objeto em cache foi acedido pela última vez e o momento em que esse objeto expira. Se este valor for equivalente a 20 minutos, o objeto expirará e será removido da cache 20 minutos após o seu último acesso. Se estiver a usar expiração deslizante, o absoluteExpiration parâmetro deve ser definido para NoAbsoluteExpiration.

onUpdateCallback: CacheItemUpdateCallback

Um delegado que será chamado antes de o objeto ser removido da cache. Podes usar isto para atualizar o item em cache e garantir que não é removido da cache.

Exceções

ArgumentNullException

O key, , ou onUpdateCallback parâmetro é nullvalue.

ArgumentOutOfRangeException

Define o slidingExpiration parâmetro para menos ou TimeSpan.Zero equivalente a mais de um ano.

ArgumentException

Os absoluteExpiration parâmetros e slidingExpiration estão ambos definidos para o item que está a tentar adicionar ao Cache.

-ou-

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

Observações

O Insert método permite-lhe inserir um novo item na cache e fornecer um delegado que é chamado antes de o item ser removido da cache. No delegado, podes atualizar o item em cache e assim evitar que seja removido da cache.

Este método irá sobrescrever um item existente Cache com o mesmo key parâmetro.

Se pretende que o item da cache expire após um período definido desde a última vez que o item foi acedido, define o slidingExpiration parâmetro para o intervalo de expiração e define o absoluteExpiration parâmetro para NoAbsoluteExpiration.

Ver também

CacheItemUpdateCallback

Aplica-se a

Insert(String, Object, CacheDependency)

Insere um objeto no Cache que tem dependências de ficheiro 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 inserir na cache.

dependencies: CacheDependency

As dependências do ficheiro ou da chave de cache para o objeto inserido. Quando qualquer dependência muda, o objeto torna-se inválido e é removido da cache. Se não existirem dependências, este parâmetro contém null.

Exceções

ArgumentNullException

O key parâmetro ou value é null.

Exemplos

O exemplo seguinte demonstra como inserir um item na cache de uma aplicação com uma dependência da cache de um ficheiro de configuração XML.

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

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

Observações

Este método irá sobrescrever um item de cache existente cuja chave corresponde ao key parâmetro. O objeto adicionado à cache usando esta sobrecarga do Insert método é inserido com uma prioridade de Default, um valor de expiração deslizante de NoSlidingExpiration, e um valor absoluto de expiração de NoAbsoluteExpiration.

Ver também

CacheDependency

Aplica-se a

Insert(String, Object)

Insere um item no Cache objeto com uma chave de cache para referenciar a sua localização, usando os valores predefinidos 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 na cache.

Exceções

ArgumentNullException

O key parâmetro ou value é null.

Exemplos

O exemplo seguinte demonstra como inserir um item na cache de uma aplicação.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Observações

Este método irá sobrescrever um item de cache existente cuja chave corresponde ao key parâmetro. O objeto adicionado à cache usando esta sobrecarga do Insert método é inserido sem dependências de ficheiros ou cache, com uma prioridade de Default, um valor de expiração deslizante de NoSlidingExpiration, e um valor absoluto de expiração de NoAbsoluteExpiration.

Ver também

Cache de Dados de Aplicação

Aplica-se a

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

Insere um objeto no Cache com dependências e políticas de 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 inserir na cache.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

O intervalo entre o momento em que o objeto inserido é acedido pela última vez e o momento em que esse objeto expira. Se este valor for equivalente a 20 minutos, o objeto expirará e será removido da cache 20 minutos após o seu último acesso. Se estiver a usar expiração deslizante, o absoluteExpiration parâmetro deve ser NoAbsoluteExpiration.

Exceções

ArgumentNullException

O key parâmetro ou value é null.

ArgumentOutOfRangeException

Define o slidingExpiration parâmetro para menos ou TimeSpan.Zero equivalente a mais de um ano.

ArgumentException

Os absoluteExpiration parâmetros e slidingExpiration estão ambos definidos para o item que está a tentar adicionar ao Cache.

Exemplos

O exemplo seguinte demonstra como inserir um item na cache de uma aplicação com expiração absoluta.

Note

Como esta forma do método Insert suporta dependências de cache, se o item não tiver dependências, deve 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 seguinte demonstra como inserir um item na 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))

Observações

Este método irá sobrescrever um item existente Cache com o mesmo key parâmetro.

Se o slidingExpiration parâmetro for definido para NoSlidingExpiration, a expiração deslizante está desativada. Se definir o slidingExpiration parâmetro como maior que Zero, o absoluteExpiration parâmetro é definido como Now mais o valor contido no slidingExpiration parâmetro. Se o item for solicitado à cache antes do tempo especificado pelo absoluteExpiration parâmetro, o item será colocado novamente na cache e absoluteExpiration será novamente definido para DateTime.Now mais o valor contido no slidingExpiration parâmetro. Se o item não for solicitado da cache antes da data indicada no absoluteExpiration parâmetro, o item é removido da cache. O item adicionado à cache usando esta sobrecarga do método de inserção é inserido com uma prioridade de Default.

Ver também

Aplica-se a

Comentários

Esta página foi útil?