Compartilhar via


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

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

Comentários

O controle dá suporte ao SqlDataSource cache de dados. Enquanto os dados são 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 das SelectCommandpropriedades , ConnectionStringe SelectParameters . 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ê estiver usando a representação do cliente na autenticação do Microsoft Windows, os dados serão armazenados em cache quando o primeiro usuário acessar 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 para o 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 dos dados seja verificada pelas configurações de segurança do banco de dados, não use cache.

Aplica-se a

Confira também