SqlDataSource.CacheKeyDependency Propiedad

Definición

Obtiene o establece una dependencia de clave definida por el usuario que está vinculada a todos los objetos de caché de datos creados por el control de origen de datos. Todos los objetos de caché expiran explícitamente cuando expira la clave.

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

String

Una clave que identifica todos los objetos de caché creados por el objeto SqlDataSource.

Comentarios

El SqlDataSource control admite el almacenamiento en caché de datos. Mientras los datos se almacenan en caché, el Select método recupera datos de la memoria caché en lugar de de la base de datos subyacente. Cuando expira la memoria caché, el Select método recupera datos de la base de datos subyacente y, a continuación, vuelve a almacenar en caché los datos.

Puede establecer la CacheKeyDependency propiedad para crear una dependencia entre todas las entradas de caché creadas por el SqlDataSource control y la clave. Puede expirar mediante programación todas las entradas de caché en cualquier momento expirando la clave.

El SqlDataSource control solo puede almacenar en caché los datos cuando están en el DataSet modo . El método produce Select una NotSupportedException excepción, si el SqlDataSource control se establece en el DataReader valor y el almacenamiento en caché también está habilitado.

Se crea una entrada de caché única para cada combinación de las SelectCommandpropiedades , ConnectionStringy SelectParameters . Varios SqlDataSource controles pueden usar las mismas entradas de caché en escenarios en los que los controles cargan los mismos datos de la misma base de datos subyacente.

Importante

Cuando se usa la suplantación de cliente en Microsoft autenticación de Windows, los datos se almacenan en caché cuando el primer usuario accede a los datos. Si otro usuario solicita los mismos datos, los datos se recuperan de la memoria caché. Los datos no se recuperan realizando otra llamada a la base de datos para comprobar el acceso del usuario a los datos. Si espera que más de un usuario acceda a los datos y desea que las configuraciones de seguridad de la base de datos comprueben cada recuperación de los datos, no use el almacenamiento en caché.

Se aplica a

Consulte también