SqlDependency Clase

Definición

El objeto SqlDependency representa una dependencia de notificación de consulta entre una aplicación y una instancia de SQL Server.The SqlDependency object represents a query notification dependency between an application and an instance of SQL Server. Una aplicación puede crear un objeto SqlDependency y registrarlo para recibir notificaciones a través del controlador de eventos OnChangeEventHandler.An application can create a SqlDependency object and register to receive notifications via the OnChangeEventHandler event handler.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public 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 is ideal for caching scenarios, where your ASP.NET application or middle-tier service needs to keep certain information cached in memory. SqlDependency permite recibir notificaciones cuando cambian los datos originales de la base de datos para que se pueda actualizar la memoria caché.SqlDependency allows you to receive notifications when the original data in the database changes so that the cache can be refreshed.

Para establecer una dependencia, debe asociar un objeto de tipo SqlDependency a uno o varios objetos de tipo SqlCommand.To set up a dependency, you need to associate a SqlDependency object to one or more SqlCommand objects. Para recibir notificaciones, es necesario suscribirse al evento OnChange.To receive notifications, you need to subscribe to the OnChange event. Para obtener más información sobre los requisitos para crear consultas para las notificaciones, consulte trabajar con notificaciones de consulta.For more information about the requirements for creating queries for notifications, see Working with Query Notifications.

Nota

SqlDependency se diseñó para usarse en los servicios de nivel intermedio o ASP.NET en los que hay un número relativamente pequeño de servidores que tienen dependencias activas con respecto a la base de datos.SqlDependency was designed to be used in ASP.NET or middle-tier services where there is a relatively small number of servers having dependencies active against the database. 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.It was not designed for use in client applications, where hundreds or thousands of client computers would have SqlDependency objects set up for a single database server. 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.If you are developing an application where you need reliable sub-second notifications when data changes, review the sections Planning an Efficient Query Notifications Strategy and Alternatives to Query Notifications in the Planning for Notifications article.

Para obtener más información, consulte notificaciones de consulta en SQL Server y Construyendo soluciones de notificación.For more information, see Query Notifications in SQL Server and Building Notification Solutions.

Nota

El evento OnChange pueden generarse en un subproceso distinto del subproceso que inició la ejecución del comando.The OnChange event may be generated on a different thread from the thread that initiated command execution.

Las notificaciones de consulta solo son compatibles con las instrucciones SELECT que cumplen ciertos requisitos específicos.Query notifications are supported only for SELECT statements that meet a list of specific requirements.

Constructores

SqlDependency()

Crea una nueva instancia de la clase SqlDependency con la configuración predeterminada.Creates a new instance of the SqlDependency class with the default settings.

SqlDependency(SqlCommand)

Crea una nueva instancia de la clase SqlDependency y la asocia al parámetro SqlCommand.Creates a new instance of the SqlDependency class and associates it with the SqlCommand parameter.

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.Creates a new instance of the SqlDependency class, associates it with the SqlCommand parameter, and specifies notification options and a time-out value.

Propiedades

HasChanges

Obtiene un valor que indica si ha cambiado uno de los conjuntos de resultados asociados a la dependencia.Gets a value that indicates whether one of the result sets associated with the dependency has changed.

Id

Obtiene un valor que identifica únicamente esta instancia de la clase SqlDependency.Gets a value that uniquely identifies this instance of the SqlDependency class.

Métodos

AddCommandDependency(SqlCommand)

Asocia un objeto SqlCommand a esta instancia de SqlDependency.Associates a SqlCommand object with this SqlDependency instance.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(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.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string.

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.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string using the specified SQL Server Service Broker queue.

Stop(String)

Detiene un agente de escucha de una conexión especificada en una anterior llamada a Start.Stops a listener for a connection specified in a previous Start call.

Stop(String, String)

Detiene un agente de escucha de una conexión especificada en una anterior llamada a Start.Stops a listener for a connection specified in a previous Start call.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Eventos

OnChange

Se produce al recibir una notificación para cualquiera de los comandos asociados a este objeto SqlDependency.Occurs when a notification is received for any of the commands associated with this SqlDependency object.

Se aplica a

Consulte también: