SqlDependency Clase

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

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 sealed

public sealed class SqlDependency

type SqlDependency = class

Public NotInheritable Class SqlDependency

Herencia

Object

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.
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(String).
Stop(String, String)	Detiene un agente de escucha de una conexión especificada en una anterior llamada a Start(String, String).

Eventos

OnChange

Se produce al recibir una notificación para cualquiera de los comandos asociados a este objeto SqlDependency.