SqlDependency.Start Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

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

Start(String)

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

public:
 static bool Start(System::String ^ connectionString);

public static bool Start (string connectionString);

static member Start : string -> bool

Public Shared Function Start (connectionString As String) As Boolean

Параметры

connectionString

String

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

Возвращаемое значение

Boolean

Значение true, если прослушиватель инициализирован успешно; значение false, если совместимый прослушиватель уже существует.

Исключения

ArgumentNullException

Параметр connectionString имеет значение NULL.

InvalidOperationException

Параметр connectionString такой же, как в предыдущем вызове этого метода, но параметры различны.

Этот метод вызывается из CLR.

SecurityException

Вызывающий код не имеет разрешения на управление доступом для кода (CAS), возвращенного SqlClientPermission.

SqlException

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

Кроме того, любые базовые исключения SqlClient.

Комментарии

Этот метод запускает прослушиватель для AppDomain для получения уведомлений о зависимостях от экземпляра SQL Server, указанного параметром connectionString . Этот метод может вызываться несколько раз с разными строками подключения для нескольких серверов.

Дополнительные примечания см. в разделе Start.

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

• ConnectionString

Start(String, String)

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

public:
 static bool Start(System::String ^ connectionString, System::String ^ queue);

public static bool Start (string connectionString, string queue);

static member Start : string * string -> bool

Public Shared Function Start (connectionString As String, queue As String) As Boolean

Параметры

connectionString

String

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

queue

String

Будет использоваться существующая очередь сервис-брокера SQL Server. Если значение null, используется очередь по умолчанию.

Возвращаемое значение

Boolean

Значение true, если прослушиватель инициализирован успешно; значение false, если совместимый прослушиватель уже существует.

Исключения

ArgumentNullException

Параметр connectionString имеет значение NULL.

InvalidOperationException

Параметр connectionString такой же, как в предыдущем вызове этого метода, но параметры различны.

Этот метод вызывается из CLR.

SecurityException

Вызывающий код не имеет разрешения на управление доступом для кода (CAS), возвращенного SqlClientPermission.

SqlException

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

Кроме того, любые базовые исключения SqlClient.

Комментарии

Этот метод запускает прослушиватель для AppDomain для получения уведомлений о зависимостях от экземпляра SQL Server, указанного параметром connectionString . Этот метод может вызываться несколько раз с разными строками подключения для нескольких серверов.

Если имя очереди не указано, SqlDependency создает временную очередь и службу на сервере, которые используются для всего процесса, даже если процесс включает несколько AppDomain. Очередь и служба автоматически удаляются после завершения работы приложения.

Дополнительные примечания см. в разделе Start.

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

• ConnectionString