SqlDependency Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
El objeto SqlDependency representa una dependencia de notificación de consulta entre una aplicación y una instancia de SQL Server. Una aplicación puede crear un SqlDependency objeto y registrarse para recibir notificaciones a través del controlador de OnChangeEventHandler eventos.
public ref class SqlDependency sealedpublic sealed class SqlDependencytype SqlDependency = classPublic NotInheritable Class SqlDependency- Herencia
-
SqlDependency
Comentarios
SqlDependency es ideal para escenarios de almacenamiento en caché, donde la aplicación de ASP.NET o el servicio de nivel intermedio deben mantener cierta información almacenada en caché en la memoria. SqlDependency permite recibir notificaciones cuando cambian los datos originales de la base de datos para que se pueda actualizar la memoria caché.
Para configurar una dependencia, debe asociar un SqlDependency objeto a uno o varios SqlCommand objetos. Para recibir notificaciones, debe suscribirse al OnChange evento. Para obtener más información sobre los requisitos para crear consultas para notificaciones, vea Trabajar con notificaciones de consulta.
Note
SqlDependency se diseñó para usarse en ASP.NET o servicios de nivel intermedio en los que hay un número relativamente pequeño de servidores que tienen dependencias activas en la base de datos. No se diseñó para su uso en aplicaciones cliente, donde cientos o miles de equipos cliente tendría SqlDependency objetos configurados para un único servidor de bases de datos. Si está desarrollando una aplicación que necesite las notificaciones de subsegundo confiables cuando cambian los datos, revise las secciones planear una estrategia eficaz de notificaciones de consulta y alternativas a las notificaciones de consulta en el artículo planear notificaciones.
Para obtener más información, vea Query Notifications in SQL Server and Building Notification Solutions.
Note
El OnChange evento se puede generar en un subproceso diferente del subproceso que inició la ejecución del comando.
Se admiten notificaciones de consultas solo para las instrucciones SELECT que cumplan un listado de requisitos específicos.
Constructores
| Nombre | Description |
|---|---|
| SqlDependency() |
Crea una nueva instancia de la SqlDependency clase con la configuración predeterminada. |
| SqlDependency(SqlCommand, String, Int32) |
Crea una nueva instancia de la SqlDependency clase , la asocia al SqlCommand parámetro y especifica las opciones de notificación y un valor de tiempo de espera. |
| SqlDependency(SqlCommand) |
Crea una nueva instancia de la SqlDependency clase y la asocia al SqlCommand parámetro . |
Propiedades
| Nombre | Description |
|---|---|
| HasChanges |
Obtiene un valor que indica si uno de los conjuntos de resultados asociados a la dependencia ha cambiado. |
| Id |
Obtiene un valor que identifica de forma única esta instancia de la SqlDependency clase . |
Métodos
| Nombre | Description |
|---|---|
| AddCommandDependency(SqlCommand) |
Asocia un SqlCommand objeto a esta SqlDependency instancia. |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| Start(String, String) |
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server especificada por el cadena de conexión mediante la cola de Service Broker SQL Server especificada. |
| Start(String) |
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server especificada por el cadena de conexión. |
| Stop(String, String) |
Detiene un agente de escucha para una conexión especificada en una llamada anterior Start . |
| Stop(String) |
Detiene un agente de escucha para una conexión especificada en una llamada anterior Start . |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Eventos
| Nombre | Description |
|---|---|
| OnChange |
Se produce cuando se recibe una notificación para cualquiera de los comandos asociados a este SqlDependency objeto. |