SqlDataSource.CacheKeyDependency Propriedade

Definição

Obtém ou define uma dependência de chave definida pelo usuário que é vinculada a todos os objetos de cache de dados que são criados pelo controle de fonte de dados. Todos os objetos de cache expiram explicitamente quando a chave expira.

public:
 virtual property System::String ^ CacheKeyDependency { System::String ^ get(); void set(System::String ^ value); };
public virtual string CacheKeyDependency { get; set; }
member this.CacheKeyDependency : string with get, set
Public Overridable Property CacheKeyDependency As String

Valor da propriedade

String

Uma chave que identifica todos os objetos de cache criados pelo SqlDataSource.

Comentários

O SqlDataSource controle dá suporte ao cache de dados. Embora os dados sejam armazenados em cache, o Select método recupera dados do cache em vez do banco de dados subjacente. Quando o cache expira, o Select método recupera dados do banco de dados subjacente e armazena os dados em cache novamente.

Você pode definir a CacheKeyDependency propriedade para criar uma dependência entre todas as entradas de cache criadas pelo SqlDataSource controle e pela chave. Você pode expirar programaticamente todas as entradas de cache a qualquer momento expirando a chave.

O SqlDataSource controle só pode armazenar dados em cache quando estiver no DataSet modo. Uma NotSupportedException exceção será gerada pelo Select método, se o SqlDataSource controle estiver definido como o valor e o DataReader cache também estiver habilitado.

Uma entrada de cache exclusiva é criada para cada combinação de SelectCommandConnectionStringpropriedades e SelectParameters propriedades. Vários SqlDataSource controles podem usar as mesmas entradas de cache em cenários em que os controles carregam os mesmos dados do mesmo banco de dados subjacente.

Importante

Quando você está usando a representação do cliente no Microsoft autenticação do Windows, os dados são armazenados em cache quando o primeiro usuário acessa os dados. Se outro usuário solicitar os mesmos dados, os dados serão recuperados do cache. Os dados não são recuperados fazendo outra chamada ao banco de dados para verificar o acesso do usuário aos dados. Se você espera que mais de um usuário acesse os dados e deseja que cada recuperação para os dados seja verificada pelas configurações de segurança do banco de dados, não use o cache.

Aplica-se a

Confira também