SqlDependency Classe

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

O objeto SqlDependency representa uma dependência de notificação de consulta entre uma aplicação e uma instância de SQL Server. Uma aplicação pode criar um SqlDependency objeto e registar-se para receber notificações através do gestor de OnChangeEventHandler eventos.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Herança
Object
SqlDependency

Observações

SqlDependency é ideal para cenários de cache, onde a sua aplicação ASP.NET ou serviço intermédio precisa de manter certa informação armazenada em memória. SqlDependency permite receber notificações quando os dados originais na base de dados mudam, para que a cache possa ser atualizada.

Para configurar uma dependência, é necessário associar um SqlDependency objeto a um ou mais SqlCommand objetos. Para receber notificações, é necessário subscrever o OnChange evento. Para mais informações sobre os requisitos para criar consultas para notificações, consulte Trabalhar com Notificações de Consultas.

Note

SqlDependency foi concebido para ser usado em serviços de ASP.NET ou de nível intermédio, onde existe um número relativamente pequeno de servidores com dependências ativas na base de dados. Não foi concebido para uso em aplicações cliente, onde centenas ou milhares de computadores clientes tinham SqlDependency objetos configurados para um único servidor de base de dados. Se você estiver desenvolvendo um aplicativo em que precise de notificações confiáveis em subsegundos quando os dados forem alterados, revise as seções Planejando uma estratégia eficiente de notificações de consulta e Alternativas às notificações de consulta no artigo Planejando notificações .

Para mais informações, consulte Notificações de Consulta em SQL Server e Building Notification Solutions.

Note

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

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

Construtores

Name Description
SqlDependency()

Cria uma nova instância da SqlDependency classe com as definições padrão.
SqlDependency(SqlCommand, String, Int32)

Cria uma nova instância da SqlDependency classe, associa-a ao SqlCommand parâmetro e especifica opções de notificação e um valor de time-out.
SqlDependency(SqlCommand)

Cria uma nova instância da SqlDependency classe e associa-a ao SqlCommand parâmetro.

Propriedades

Name Description
HasChanges

Obtém um valor que indica se um dos conjuntos de resultados associados à dependência mudou.
Id

Obtém um valor que identifica de forma única esta instância da SqlDependency classe.

Métodos

Name Description
AddCommandDependency(SqlCommand)

Associa um SqlCommand objeto a esta SqlDependency instância.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
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.
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.
Stop(String, String)

Para um ouvinte para uma ligação especificada numa chamada anterior Start .
Stop(String)

Para um ouvinte para uma ligação especificada numa chamada anterior Start .
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
OnChange

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

Aplica-se a

Ver também