SqlDependency.Start Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia o ouvinte para receber notificações de alteração de dependência.
Sobrecargas
| Nome | Description |
|---|---|
| Start(String) |
Inicia o ouvinte para receber notificações de alteração de dependência da instância de SQL Server especificada pelo cadeia de conexão. |
| Start(String, String) |
Inicia o ouvinte para receber notificações de alteração de dependência da instância de SQL Server especificada pelo cadeia de conexão usando a fila especificada SQL Server Service Broker. |
Comentários
O ouvinte SqlDependency 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 (as mesmas credenciais de cadeia de conexão e 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 para o grupo, pois diferentes usuários podem assinar e escutar (usando SqlCacheDependency ou SqlCommand) em uma fila de notificação criada por um administrador. Quando o domínio de 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 Start é 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 de SQL Server especificada pelo cadeia de conexã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
O cadeia de conexão para a instância de SQL Server da qual obter notificações de alteração.
Retornos
true se o ouvinte foi inicializado com êxito; false se já existir um ouvinte compatível.
Exceções
O connectionString parâmetro é NULL.
O connectionString parâmetro é o mesmo que uma chamada anterior para esse método, mas os parâmetros são diferentes.
O método foi chamado de dentro do CLR.
O chamador não tem a permissão CAS (segurança de acesso ao código) necessária SqlClientPermission .
Uma chamada subsequente para o método foi feita com um parâmetro equivalente connectionString com um usuário diferente ou um usuário que não usa o mesmo esquema.
Além disso, quaisquer exceções subjacentes do SqlClient .
Comentários
Esse método inicia o ouvinte do AppDomain para receber notificações de dependência da instância de SQL Server especificada pelo parâmetro connectionString. 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 de SQL Server especificada pelo cadeia de conexão usando a fila especificada 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
O cadeia de conexão para a instância de SQL Server da qual obter notificações de alteração.
- queue
- String
Uma fila existente SQL Server Service Broker a ser usada. Se null, a fila padrão será usada.
Retornos
true se o ouvinte foi inicializado com êxito; false se já existir um ouvinte compatível.
Exceções
O connectionString parâmetro é NULL.
O connectionString parâmetro é o mesmo que uma chamada anterior para esse método, mas os parâmetros são diferentes.
O método foi chamado de dentro do CLR.
O chamador não tem a permissão CAS (segurança de acesso ao código) necessária SqlClientPermission .
Uma chamada subsequente para o método foi feita com um parâmetro equivalente connectionString , mas um usuário diferente ou um usuário que não usa o mesmo esquema.
Além disso, quaisquer exceções subjacentes do SqlClient .
Comentários
Esse método inicia o ouvinte do AppDomain para receber notificações de dependência da instância de SQL Server especificada pelo parâmetro connectionString. 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 temporária e um serviço no servidor que é usado 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.