SqlDependency Classe

Definição

O objeto SqlDependency representa uma dependência de notificação de consulta entre um aplicativo e uma instância do SQL Server.The SqlDependency object represents a query notification dependency between an application and an instance of SQL Server. Um aplicativo pode criar um objeto SqlDependency e registrar-se para receber notificações por meio do manipulador de eventos OnChangeEventHandler.An application can create a SqlDependency object and register to receive notifications via the OnChangeEventHandler event handler.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Herança
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 is ideal for caching scenarios, where your ASP.NET application or middle-tier service needs to keep certain information cached in memory. SqlDependency o permite que você receba notificações quando os dados originais são alterados para que o cache possa ser atualizado.SqlDependency allows you to receive notifications when the original data in the database changes so that the cache can be refreshed.

Para configurar uma dependência, você precisa associar um SqlDependency objeto a um ou mais SqlCommand objetos.To set up a dependency, you need to associate a SqlDependency object to one or more SqlCommand objects. Para receber notificações, você precisa assinar o OnChange evento.To receive notifications, you need to subscribe to the OnChange event. Para obter mais informações sobre os requisitos para criar consultas para notificações, consulte trabalhando com notificações de consulta.For more information about the requirements for creating queries for notifications, see Working with Query Notifications.

Observação

SqlDependency foi projetado para ser usado em serviços 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.SqlDependency was designed to be used in ASP.NET or middle-tier services where there is a relatively small number of servers having dependencies active against the database. 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.It was not designed for use in client applications, where hundreds or thousands of client computers would have SqlDependency objects set up for a single database server. Se você estiver desenvolvendo um aplicativo onde precisa de notificações de subsegundo confiáveis quando os dados forem alterados, examine as seções planejando uma estratégia de notificações de consulta eficiente e alternativas para notificações de consulta no artigo planejamento de notificações .If you are developing an application where you need reliable sub-second notifications when data changes, review the sections Planning an Efficient Query Notifications Strategy and Alternatives to Query Notifications in the Planning for Notifications article.

Para obter mais informações, consulte notificações de consulta em SQL Server e criando soluções de notificação.For more information, see Query Notifications in SQL Server and Building Notification Solutions.

Observação

O OnChange evento pode ser gerado em um thread diferente do thread que iniciou a execução do comando.The OnChange event may be generated on a different thread from the thread that initiated command execution.

As notificações de consulta são compatíveis apenas com instruções SELECT que atendem a uma lista de requisitos específicos.Query notifications are supported only for SELECT statements that meet a list of specific requirements.

Construtores

SqlDependency()

Cria uma nova instância da classe SqlDependency com as configurações padrão.Creates a new instance of the SqlDependency class with the default settings.

SqlDependency(SqlCommand)

Cria uma nova instância da classe SqlDependency e a associa-a ao parâmetro SqlCommand.Creates a new instance of the SqlDependency class and associates it with the SqlCommand parameter.

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.Creates a new instance of the SqlDependency class, associates it with the SqlCommand parameter, and specifies notification options and a time-out value.

Propriedades

HasChanges

Obtém um valor que indica se um dos conjuntos de resultados associados à dependência foi alterado.Gets a value that indicates whether one of the result sets associated with the dependency has changed.

Id

Obtém um valor que identifica essa instância da classe SqlDependency de forma exclusiva.Gets a value that uniquely identifies this instance of the SqlDependency class.

Métodos

AddCommandDependency(SqlCommand)

Associa um objeto SqlCommand a esta instância SqlDependency.Associates a SqlCommand object with this SqlDependency instance.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
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.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string.

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.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string using the specified SQL Server Service Broker queue.

Stop(String)

Interrompe um ouvinte para uma conexão especificada na chamada Start anterior.Stops a listener for a connection specified in a previous Start call.

Stop(String, String)

Interrompe um ouvinte para uma conexão especificada na chamada Start anterior.Stops a listener for a connection specified in a previous Start call.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Eventos

OnChange

Ocorre quando uma notificação é recebida para um dos comandos associados a este objeto SqlDependency.Occurs when a notification is received for any of the commands associated with this SqlDependency object.

Aplica-se a