SqlDependency Classe

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

O objeto SqlDependency representa uma dependência de notificação de consulta entre um aplicativo e uma instância do SQL Server. Um aplicativo pode criar um objeto SqlDependency e registrar-se para receber notificações por meio do manipulador de eventos OnChangeEventHandler.

public ref class SqlDependency sealed

public sealed class SqlDependency

type SqlDependency = class

Public NotInheritable Class SqlDependency

Herança

Object

SqlDependency

Comentários

SqlDependency é ideal para cenários de cache, em que seu aplicativo de ASP.NET ou serviço de camada intermediária precisa manter determinadas informações armazenadas em cache na memória. SqlDependency permite que você receba notificações quando os dados originais no banco de dados forem alterados para que o cache possa ser atualizado.

Para configurar uma dependência, você precisa associar um SqlDependency objeto a um ou mais SqlCommand objetos. Para receber notificações, você precisa assinar o OnChange evento. Para obter mais informações sobre os requisitos para criar consultas para notificações, consulte Trabalhando com notificações de consulta.

Observação

SqlDependency foi projetado para ser usado em serviços de ASP.NET ou de camada intermediária em que há um número relativamente pequeno de servidores com dependências ativas no banco de dados. Ele não foi projetado para uso em aplicativos cliente, em que centenas ou milhares de computadores cliente teriam SqlDependency objetos configurados para um único servidor de banco de dados. Se você estiver desenvolvendo um aplicativo em que precise receber notificações confiáveis imediatamente quando os dados forem alterados, examine as seções Planejando uma estratégia eficiente das notificações de consulta e Alternativas para notificações de consulta no artigo Planejando para notificações.

Para obter mais informações, consulte Notificações de consulta no SQL Server e Criando soluções de notificação.

Observação

O OnChange evento pode ser gerado em um thread diferente do thread que iniciou a execução do comando.

As notificações de consulta são compatíveis apenas com instruções SELECT que atendem a uma lista de requisitos específicos.

Construtores

SqlDependency()	Cria uma nova instância da classe SqlDependency com as configurações padrão.
SqlDependency(SqlCommand)	Cria uma nova instância da classe SqlDependency e a associa-a ao parâmetro SqlCommand.
SqlDependency(SqlCommand, String, Int32)	Cria uma nova instância da classe SqlDependency, a associa ao parâmetro SqlCommand e especifica opções de notificação e um valor de tempo limite.

Propriedades

HasChanges	Obtém um valor que indica se um dos conjuntos de resultados associados à dependência foi alterado.
Id	Obtém um valor que identifica essa instância da classe SqlDependency de forma exclusiva.

Métodos

AddCommandDependency(SqlCommand)	Associa um objeto SqlCommand a esta instância SqlDependency.
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.
Stop(String)	Interrompe um ouvinte para uma conexão especificada na chamada Start(String) anterior.
Stop(String, String)	Interrompe um ouvinte para uma conexão especificada na chamada Start(String, String) anterior.

Eventos

OnChange

Ocorre quando uma notificação é recebida para um dos comandos associados a este objeto SqlDependency.