SqlDependency Classe

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

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

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 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.

Note

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 as notificações Query no SQL Server e Building Notification Solutions.

Note

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

Nome Description
SqlDependency()

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

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

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

Propriedades

Nome Description
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 exclusivamente essa instância da SqlDependency classe.

Métodos

Nome Description
AddCommandDependency(SqlCommand)

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

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

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

Interrompe um ouvinte para uma conexão especificada em uma chamada anterior Start .
Stop(String)

Interrompe um ouvinte para uma conexão especificada em uma chamada anterior Start .
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

Nome Description
OnChange

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

Aplica-se a

Confira também