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 objeto SqlDependency y registrarlo para recibir notificaciones a través del controlador de eventos OnChangeEventHandler.
public ref class SqlDependency sealedpublic sealed class SqlDependencytype SqlDependency = classPublic NotInheritable Class SqlDependency- Herencia
-
SqlDependency
Comentarios
SqlDependency es ideal para escenarios, donde la aplicación ASP.NET o servicio de nivel intermedio debe mantener cierta información en memoria caché. SqlDependency permite recibir notificaciones cuando cambian los datos originales de la base de datos para que se pueda actualizar la memoria caché.
Para establecer una dependencia, debe asociar un objeto de tipo SqlDependency a uno o varios objetos de tipo SqlCommand. Para recibir notificaciones, es necesario suscribirse al evento OnChange. Para obtener más información sobre los requisitos para crear consultas para notificaciones, consulte Trabajar con notificaciones de consulta.
Nota
SqlDependency se diseñó para usarse en ASP.NET o servicios de nivel intermedio donde 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 podrían tener cientos o miles de equipos cliente con objetos SqlDependency configurado para un único servidor de base 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, consulte notificaciones de consulta en SQL Server y Construyendo soluciones de notificación.
Nota
El evento OnChange pueden generarse en un subproceso distinto 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
| SqlDependency() |
Crea una nueva instancia de la clase SqlDependency con la configuración predeterminada. |
| SqlDependency(SqlCommand) |
Crea una nueva instancia de la clase SqlDependency y la asocia al parámetro SqlCommand. |
| SqlDependency(SqlCommand, String, Int32) |
Crea una nueva instancia de la clase SqlDependency, la asocia al parámetro SqlCommand y especifica las opciones de notificación y un valor de tiempo de espera. |
Propiedades
| HasChanges |
Obtiene un valor que indica si ha cambiado uno de los conjuntos de resultados asociados a la dependencia. |
| Id |
Obtiene un valor que identifica únicamente esta instancia de la clase SqlDependency. |
Métodos
| AddCommandDependency(SqlCommand) |
Asocia un objeto SqlCommand a esta instancia de SqlDependency. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve 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 Object actual. (Heredado de Object) |
| Start(String) |
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server que especifique la cadena de conexión. |
| Start(String, String) |
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server que especifique la cadena de conexión utilizando la cola de SQL Server Service Broker indicada. |
| Stop(String) |
Detiene un agente de escucha de una conexión especificada en una anterior llamada a Start. |
| Stop(String, String) |
Detiene un agente de escucha de una conexión especificada en una anterior llamada a Start. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Eventos
| OnChange |
Se produce al recibir una notificación para cualquiera de los comandos asociados a este objeto SqlDependency. |
