SqlDependency Класс

Определение

Объект SqlDependency представляет зависимость уведомления о запросе между приложением и экземпляром SQL Server. Приложение может создавать объект SqlDependency и регистрироваться для получения уведомлений через обработчик событий OnChangeEventHandler.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Наследование
SqlDependency

Комментарии

SqlDependency идеально подходит для сценариев кэширования, в которых ASP.NET приложение или служба среднего уровня должны хранить определенную информацию в кэше в памяти. SqlDependency позволяет получать уведомления при изменении исходных данных в базе данных для обновления кэша.

Чтобы настроить зависимость, необходимо связать SqlDependency объект с одним или SqlCommand несколькими объектами. Чтобы получать уведомления, необходимо подписаться на OnChange событие. Дополнительные сведения о требованиях к созданию запросов для уведомлений см. в разделе Работа с уведомлениями запросов.

Примечание

SqlDependency предназначен для использования в службах ASP.NET или среднего уровня, где имеется относительно небольшое количество серверов с активными зависимостями от базы данных. Он не предназначен для использования в клиентских приложениях, где на сотнях или тысячах клиентских компьютеров объекты SqlDependency будут настроены для одного сервера базы данных. Если вы разрабатываете приложение, в котором требуются надежные субсекундные уведомления при изменении данных, ознакомьтесь с разделами Planning an Efficient Query Notifications Strategy (Планирование эффективной стратегии уведомлений о запросах ) и Alternatives to Query Notifications (Альтернативы уведомлениям запросов) статьи Planning for Notifications (Планирование эффективной стратегии уведомлений запросов) и Alternatives to Query Notifications (Планирование уведомлений).

Дополнительные сведения см. в разделах Уведомления о запросах в SQL Server и Создание решений для уведомлений.

Примечание

Событие OnChange может быть создано в потоке, отличном от потока, который инициировал выполнение команды.

Уведомления о запросах поддерживаются только для инструкций SELECT, которые соответствуют конкретным требованиям.

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

SqlDependency()

Создает новый экземпляр класса SqlDependency, используя значения по умолчанию.

SqlDependency(SqlCommand)

Создает новый экземпляр класса SqlDependency и связывает его с параметром SqlCommand.

SqlDependency(SqlCommand, String, Int32)

Создает новый экземпляр класса SqlDependency и связывает его с параметром SqlCommand, а также задает параметры уведомления и таймаут.

Свойства

HasChanges

Возвращает значение, указывающее, изменился ли какой-либо из результирующих наборов, связанных с данной зависимостью.

Id

Возвращает значение, являющееся уникальным идентификатором данного экземпляра класса SqlDependency.

Методы

AddCommandDependency(SqlCommand)

Связывает объект SqlCommand с этим экземпляром SqlDependency.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

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

Служит хэш-функцией по умолчанию.

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

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

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

Создает неполную копию текущего объекта Object.

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

Запускает прослушиватель для получения уведомлений об изменении зависимости от экземпляра SQL Server, заданного в строке подключения.

Start(String, String)

Запускает прослушиватель для получения уведомлений об изменении зависимости от экземпляра SQL Server, заданного в строке подключения, с использованием заданной очереди сервис-брокера SQL Server.

Stop(String)

Останавливает прослушиватель для подключения, заданного в предыдущем вызове Start.

Stop(String, String)

Останавливает прослушиватель для подключения, заданного в предыдущем вызове Start.

ToString()

Возвращает строку, представляющую текущий объект.

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

События

OnChange

Генерируется при получении уведомления для любой команды, связанной с данным объектом SqlDependency.

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

См. также раздел