SqlDependency.Start Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicia o ouvinte para receber notificações de alteração de dependência.
Sobrecargas
| Name | Description |
|---|---|
| Start(String) |
Inicia o ouvinte para receber notificações de alteração de dependência a partir da instância do SQL Server especificada pela cadeia de ligação. |
| Start(String, String) |
Inicia o ouvinte para receber notificações de alteração de dependência a partir da instância do SQL Server especificada pela cadeia de ligação usando a fila especificada do SQL Server Service Broker. |
Observações
O ouvinte SqlDependency reinicia quando ocorre um erro na ligação SQL Server.
Podem ser feitas múltiplas chamadas ao Start método, sujeitas às seguintes restrições:
Múltiplas chamadas com parâmetros idênticos (a mesma cadeia de ligação e credenciais do Windows na thread que chama) são válidas.
Múltiplas chamadas com cadeias de ligação diferentes são válidas desde que:
Cada cadeia de ligação especifica uma base de dados diferente, ou
Cada cadeia de ligação especifica um utilizador diferente, ou
As chamadas vêm de diferentes domínios de aplicação.
Pode fazer o SqlDependency trabalho corretamente para aplicações que usam múltiplos threads para representar diferentes credenciais de utilizador sem atribuir o papel dbo ao grupo, porque diferentes utilizadores podem subscrever e ouvir (usando SqlCacheDependency ou) SqlCommanduma fila de notificações criada por um administrador. Quando o domínio de aplicação relevante inicia, chame Start com as credenciais (Windows) de um utilizador que tem permissão para inicializar um serviço/fila (as permissões CREATE QUEUE e CREATE SERVICE para a base de dados). Certifique-se de que o Start só é chamado uma vez por AppDomain, caso contrário é criada uma exceção de ambiguidade. O tópico de utilizador deve ter permissão para subscrever a notificação (a permissão SUBSCRIBE QUERY NOTIFICATIONS para a base de dados). SqlDependency irá associar o pedido de subscrição de um utilizador 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 a partir da instância do SQL Server especificada pela cadeia de ligação.
public:
static bool Start(System::String ^ connectionString);public static bool Start(string connectionString);static member Start : string -> boolPublic Shared Function Start (connectionString As String) As BooleanParâmetros
- connectionString
- String
A cadeia de ligação para a instância do SQL Server a partir da qual se obtêm notificações de alteração.
Devoluções
true se o ouvinte inicializou com sucesso; false se já existir um ouvinte compatível.
Exceções
O connectionString parâmetro é NULL.
O connectionString parâmetro é o mesmo de uma chamada anterior a este método, mas os parâmetros são diferentes.
O método era chamado a partir do CLR.
O chamador não tem a permissão necessária SqlClientPermission de segurança de acesso ao código (CAS).
Uma chamada subsequente ao método foi feita com um parâmetro equivalente connectionString com outro utilizador, ou com um utilizador que não utiliza o mesmo esquema por defeito.
Além disso, quaisquer exceções subjacentes ao SqlClient .
Observações
Este método inicia o ouvinte para o AppDomain para receber notificações de dependência da instância de SQL Server especificada pelo parâmetro connectionString. Este método pode ser chamado mais do que uma vez com cadeias de ligação diferentes para múltiplos servidores.
Para observações adicionais, veja Start.
Ver também
Aplica-se a
Start(String, String)
Inicia o ouvinte para receber notificações de alteração de dependência a partir da instância do SQL Server especificada pela cadeia de ligaçã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 -> boolPublic Shared Function Start (connectionString As String, queue As String) As BooleanParâmetros
- connectionString
- String
A cadeia de ligação para a instância do SQL Server a partir da qual se obtêm notificações de alteração.
- queue
- String
Uma fila existente do SQL Server Service Broker a ser utilizada. Se null, a fila padrão é usada.
Devoluções
true se o ouvinte inicializou com sucesso; false se já existir um ouvinte compatível.
Exceções
O connectionString parâmetro é NULL.
O connectionString parâmetro é o mesmo de uma chamada anterior a este método, mas os parâmetros são diferentes.
O método era chamado a partir do CLR.
O chamador não tem a permissão necessária SqlClientPermission de segurança de acesso ao código (CAS).
Foi feita uma chamada subsequente ao método com um parâmetro equivalente connectionString mas com um utilizador diferente, ou com um utilizador que não utiliza o mesmo esquema por defeito.
Além disso, quaisquer exceções subjacentes ao SqlClient .
Observações
Este método inicia o ouvinte para o AppDomain para receber notificações de dependência da instância de SQL Server especificada pelo parâmetro connectionString. Este método pode ser chamado mais do que uma vez com cadeias de ligação diferentes para múltiplos servidores.
Se não for especificado o nome da fila, cria-se SqlDependency uma fila temporária e um serviço no servidor que é usado durante todo o processo, mesmo que o processo envolva mais do que um AppDomain. A fila e o serviço são automaticamente removidos após o encerramento da aplicação.
Para observações adicionais, veja Start.