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.Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control. Todos los objetos de caché expiran explícitamente cuando expira la clave.All cache objects are explicitly expired when the key is expired.

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.A key that identifies all cache objects created by the SqlDataSource.

Comentarios

El SqlDataSource control admite el almacenamiento en caché de datos.The SqlDataSource control supports data caching. Mientras los datos se almacenan en memoria caché, el Select método recupera datos de la memoria caché en lugar de hacerlo desde la base de datos subyacente.While data is cached, the Select method retrieves data from the cache rather than from the underlying database. Cuando expira la caché, el Select método recupera datos de la base de datos subyacente y, a continuación, vuelve a almacenar en caché los datos.When the cache expires, the Select method retrieves data from the underlying database, and then caches the data again.

Puede establecer la CacheKeyDependency propiedad para crear una dependencia entre todas las entradas de caché creadas por el SqlDataSource control y la clave.You can set the CacheKeyDependency property to create a dependency between all cache entries that are created by the SqlDataSource control and the key. Puede expirar mediante programación todas las entradas de la memoria caché en cualquier momento si expira la clave.You can programmatically expire all the cache entries at any time by expiring the key.

El SqlDataSource control solo puede almacenar datos en caché en el DataSet modo.The SqlDataSource control can cache data only when in the DataSet mode. NotSupportedExceptionEl método produce una excepción Select , si el SqlDataSource control se establece en el DataReader valor y también se habilita el almacenamiento en caché.A NotSupportedException exception is thrown by the Select method, if the SqlDataSource control is set to the DataReader value and caching is also enabled.

Se crea una entrada de caché única para cada combinación de SelectCommand las ConnectionString propiedades, y SelectParameters .A unique cache entry is created for every combination of the SelectCommand, ConnectionString, and SelectParameters properties. Varios SqlDataSource controles pueden utilizar las mismas entradas de caché en escenarios donde los controles cargan los mismos datos de la misma base de datos subyacente.Multiple SqlDataSource controls can use the same cache entries in scenarios where the controls load the same data from the same underlying database.

Importante

Cuando se usa la suplantación de cliente en la autenticación de Microsoft Windows, los datos se almacenan en caché cuando el primer usuario obtiene acceso a los datos.When you are using client impersonation under Microsoft Windows authentication, the data is cached when the first user accesses the data. Si otro usuario solicita los mismos datos, los datos se recuperan de la memoria caché.If another user requests the same data, the data is retrieved from the cache. Los datos no se recuperan realizando otra llamada a la base de datos para comprobar el acceso del usuario a los datos.The data is not retrieved by making another call to the database to verify the user's access to the data. Si espera que más de un usuario tenga acceso a los datos y desea que cada recuperación de los datos sea comprobada por las configuraciones de seguridad para la base de datos, no utilice el almacenamiento en caché.If you expect more than one user to access the data, and you want each retrieval to the data to be verified by the security configurations for the database, do not use caching.

Se aplica a

Consulte también