SqlDependency Класс

Определение

Объект SqlDependency представляет зависимость уведомления о запросе между приложением и экземпляром SQL Server.The SqlDependency object represents a query notification dependency between an application and an instance of SQL Server. Приложение может создавать объект SqlDependency и регистрироваться для получения уведомлений через обработчик событий 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
Наследование
SqlDependency

Комментарии

SqlDependencyидеально подходит для сценариев кэширования, где приложение ASP.NET или служба среднего уровня должны хранить в памяти некоторую информацию, кэшированную в память.SqlDependency is ideal for caching scenarios, where your ASP.NET application or middle-tier service needs to keep certain information cached in memory. SqlDependencyпозволяет получать уведомления при изменении исходных данных в базе данных, чтобы можно было обновить кэш.SqlDependency allows you to receive notifications when the original data in the database changes so that the cache can be refreshed.

Чтобы настроить зависимость, необходимо связать SqlDependency объект с одним или несколькими SqlCommand объектами.To set up a dependency, you need to associate a SqlDependency object to one or more SqlCommand objects. Чтобы получать уведомления, необходимо подписываться на OnChange событие.To receive notifications, you need to subscribe to the OnChange event. Дополнительные сведения о требованиях к созданию запросов для уведомлений см. в разделе Работа с уведомлениями о запросах.For more information about the requirements for creating queries for notifications, see Working with Query Notifications.

Примечание

SqlDependencyпредназначен для использования в ASP.NET или службах среднего уровня, где существует относительно небольшое количество серверов, для которых имеются зависимости, активные для базы данных.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. Он не предназначен для использования в клиентских приложениях, где сотни или тысячи клиентских компьютеров будут иметь SqlDependency объекты, настроенные для одного сервера базы данных.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. Если вы разрабатываете приложение, в котором вам потребуются надежные отправки уведомлений при изменении данных, ознакомьтесь с разделом планирование эффективной стратегии уведомлений о запросах и альтернативы для уведомлений о запросах в планировании. Статья с уведомлениями.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.

Дополнительные сведения см. в статьях уведомления о запросах в SQL Server и Создание решений для уведомления.For more information, see Query Notifications in SQL Server and Building Notification Solutions.

Примечание

OnChange Событие может быть создано в другом потоке из потока, который инициировал выполнение команды.The OnChange event may be generated on a different thread from the thread that initiated command execution.

Уведомления о запросах поддерживаются только для инструкций SELECT, удовлетворяющих списку конкретных требований.Query notifications are supported only for SELECT statements that meet a list of specific requirements.

Конструкторы

SqlDependency()

Создает новый экземпляр класса SqlDependency, используя значения по умолчанию.Creates a new instance of the SqlDependency class with the default settings.

SqlDependency(SqlCommand)

Создает новый экземпляр класса SqlDependency и связывает его с параметром SqlCommand.Creates a new instance of the SqlDependency class and associates it with the SqlCommand parameter.

SqlDependency(SqlCommand, String, Int32)

Создает новый экземпляр класса SqlDependency и связывает его с параметром SqlCommand, а также задает параметры уведомления и таймаут.Creates a new instance of the SqlDependency class, associates it with the SqlCommand parameter, and specifies notification options and a time-out value.

Свойства

HasChanges

Возвращает значение, указывающее, изменился ли какой-либо из результирующих наборов, связанных с данной зависимостью.Gets a value that indicates whether one of the result sets associated with the dependency has changed.

Id

Возвращает значение, являющееся уникальным идентификатором данного экземпляра класса SqlDependency.Gets a value that uniquely identifies this instance of the SqlDependency class.

Методы

AddCommandDependency(SqlCommand)

Связывает объект SqlCommand с этим экземпляром SqlDependency.Associates a SqlCommand object with this SqlDependency instance.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Start(String)

Запускает прослушиватель для получения уведомлений об изменении зависимости от экземпляра SQL Server, заданного в строке подключения.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string.

Start(String, String)

Запускает прослушиватель для получения уведомлений об изменении зависимости от экземпляра SQL Server, заданного в строке подключения, с использованием заданной очереди сервис-брокера SQL Server.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)

Останавливает прослушиватель для подключения, заданного в предыдущем вызове Start.Stops a listener for a connection specified in a previous Start call.

Stop(String, String)

Останавливает прослушиватель для подключения, заданного в предыдущем вызове Start.Stops a listener for a connection specified in a previous Start call.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

OnChange

Генерируется при получении уведомления для любой команды, связанной с данным объектом SqlDependency.Occurs when a notification is received for any of the commands associated with this SqlDependency object.

Применяется к

Дополнительно