SqlDependency.Start Método

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

Inicia o ouvinte para receber notificações de alteração de dependência.

Sobrecargas

Start(String)

Inicia o ouvinte para receber notificações de alteração de dependência da instância do SQL Server especificada pela cadeia de conexão.
Start(String, String)

Inicia o ouvinte para receber notificações de alteração de dependência da instância do SQL Server especificada pela cadeia de conexão usando a fila especificada do SQL Server Service Broker.

Comentários

O SqlDependency ouvinte será reiniciado quando ocorrer um erro na conexão SQL Server.

Várias chamadas para o Start método podem ser feitas, sujeitas às seguintes restrições:

  • Várias chamadas com parâmetros idênticos (o mesmo cadeia de conexão e credenciais do Windows no thread de chamada) são válidas.

  • Várias chamadas com cadeias de conexão diferentes são válidas desde que:

    • Cada cadeia de conexão especifica um banco de dados diferente ou

    • Cada cadeia de conexão especifica um usuário diferente ou

    • As chamadas vêm de domínios de aplicativo diferentes.

Você pode fazer o SqlDependency trabalho corretamente para aplicativos que usam vários threads para representar credenciais de usuário diferentes sem dar a função dbo ao grupo, pois diferentes usuários podem assinar e escutar (usando SqlCacheDependency ou SqlCommand) uma fila de notificação criada por um administrador. Quando o domínio do aplicativo relevante for iniciado, chame Iniciar com as credenciais (Windows) de um usuário que tenha permissão para inicializar um serviço/fila (as permissões CREATE QUEUE e CREATE SERVICE para o banco de dados). Verifique se Iniciar é chamado apenas uma vez por AppDomain, caso contrário, uma exceção de ambiguidade é gerada. O thread do usuário deve ter permissão para assinar a notificação (a permissão SUBSCRIBE QUERY NOTIFICATIONS para o banco de dados). SqlDependency associará a solicitação de assinatura de um usuário não administrador ao serviço/fila criado pelo administrador.

Start(String)

Inicia o ouvinte para receber notificações de alteração de dependência da instância do SQL Server especificada pela cadeia de conexão.

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

Parâmetros

connectionString
String

A cadeia de conexão para a instância do SQL Server da qual as notificações de alteração serão obtidas.

Retornos

Boolean

true se o ouvinte tiver sido inicializado com êxito; false se já existir um ouvinte compatível.

Exceções

ArgumentNullException

O parâmetro connectionString é NULL.

InvalidOperationException

O parâmetro connectionString é o mesmo que uma chamada anterior a esse método, mas os parâmetros são diferentes.

O método foi chamado de dentro do CLR.

SecurityException

O chamador não tem a permissão de CAS (segurança de acesso do código) SqlClientPermission necessária.

SqlException

Foi feita uma chamada subsequente para o método com um parâmetro connectionString equivalente com um usuário diferente ou um usuário que não é o padrão para o mesmo esquema.

Além disso, todas as exceções SqlClient subjacentes.

Comentários

Esse método inicia o ouvinte do para AppDomain receber notificações de dependência da instância de SQL Server especificada pelo connectionString parâmetro . Esse método pode ser chamado mais de uma vez com cadeias de conexão diferentes para vários servidores.

Para comentários adicionais, consulte Start.

Confira também

Aplica-se a

Start(String, String)

Inicia o ouvinte para receber notificações de alteração de dependência da instância do SQL Server especificada pela cadeia de conexão usando a fila especificada do SQL Server Service Broker.

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

Parâmetros

connectionString
String

A cadeia de conexão para a instância do SQL Server da qual as notificações de alteração serão obtidas.

queue
String

Uma fila existente do SQL Server Service Broker a ser usada. Se for null, a fila padrão será usada.

Retornos

Boolean

true se o ouvinte tiver sido inicializado com êxito; false se já existir um ouvinte compatível.

Exceções

ArgumentNullException

O parâmetro connectionString é NULL.

InvalidOperationException

O parâmetro connectionString é o mesmo que uma chamada anterior a esse método, mas os parâmetros são diferentes.

O método foi chamado de dentro do CLR.

SecurityException

O chamador não tem a permissão de CAS (segurança de acesso do código) SqlClientPermission necessária.

SqlException

Foi feita uma chamada posterior ao método com um parâmetro connectionString equivalente, mas com um usuário diferente ou um usuário que não usa como padrão o mesmo esquema.

Além disso, todas as exceções SqlClient subjacentes.

Comentários

Esse método inicia o ouvinte do para AppDomain receber notificações de dependência da instância de SQL Server especificada pelo connectionString parâmetro . Esse método pode ser chamado mais de uma vez com cadeias de conexão diferentes para vários servidores.

Se nenhum nome de fila for especificado, SqlDependency criará uma fila e um serviço temporários no servidor usados para todo o processo, mesmo que o processo envolva mais de um AppDomain. A fila e o serviço são removidos automaticamente após o desligamento do aplicativo.

Para comentários adicionais, consulte Start.

Confira também

Aplica-se a