Lenguaje

Detectar cambios con SqlDependency

Para detectar cuándo los resultados de la consulta difieren de los recuperados originalmente, asocie el SqlDependency objeto con SqlCommand antes de ejecutar el comando. Suscríbase al OnChange evento para recibir una notificación cuando cambien los resultados. También puede comprobar la propiedad HasChanges de la dependencia para determinar si los resultados han cambiado.

Consideraciones sobre la seguridad

Para recibir notificaciones cuando cambien los datos subyacentes, llame a Start. La infraestructura de dependencias abre el SqlConnection para el agente de escucha. Conceda a la entidad de seguridad de la base de datos los permisos de Service Broker y de notificación de consultas requeridos. La seguridad de acceso al código no se admite en las versiones modernas de .NET. Para obtener más información, consulte Habilitación de notificaciones de consulta.

Ejemplo

En los pasos siguientes se muestra cómo declarar una dependencia, ejecutar un comando y recibir una notificación cuando cambia el conjunto de resultados:

  1. En la inicialización de la aplicación, llame a SqlDependency.Start para iniciar el listener del cliente.

  2. Cree objetos SqlConnection y SqlCommand para conectarse al servidor y defina una instrucción Transact-SQL (T-SQL).

  3. Cree o reutilice el SqlDependency objeto y asócielo al SqlCommand objeto . La dependencia crea y asocia el SqlNotificationRequest objeto con el comando según sea necesario. La solicitud de notificación contiene un identificador interno para la dependencia. El constructor no inicia el listener.

  4. Suscriba un controlador de eventos al evento OnChange del objeto SqlDependency.

  5. Ejecute el comando con uno de sus métodos Execute. Dado que el comando incluye una solicitud de notificación, el servidor registra la consulta para notificaciones en la cola especificada.

  6. En la finalización de la aplicación, llame a SqlDependency.Stop con la misma cadena de conexión y el mismo nombre de cola.

Si cualquier usuario cambia posteriormente los datos subyacentes, Microsoft SQL Server detecta que hay una notificación pendiente para ese cambio y envía una notificación que se procesa y reenvía al cliente a través del objeto SqlConnection subyacente que se creó mediante una llamada a SqlDependency.Start. El agente de escucha del cliente recibe el mensaje de invalidación. A continuación, el agente de escucha del cliente busca el objeto SqlDependency asociado y activa el evento OnChange.

El fragmento de código siguiente muestra el patrón de diseño de una aplicación de ejemplo. Instale el paquete NuGet Microsoft.Data.SqlClient e importe Microsoft.Data.SqlClient en C# o Visual Basic.

Estos fragmentos usan una cola de Service Broker existente. Establezca queueName en el nombre no calificado de la cola y notificationOptions en service=<service-name>;local database=<database-name>. Especifique el servicio que enruta las notificaciones a esa cola. Pase el mismo cadena de conexión y el nombre de la cola a Start y Stop. Para obtener más información, consulte Habilitar las notificaciones de consulta.

Sub Initialization()
    ' Create a dependency connection.
    SqlDependency.Start(connectionString, queueName)
End Sub

Sub SomeMethod()
    ' Assume connection is an open SqlConnection.
    ' Create a new SqlCommand object.
    Using command As New SqlCommand( _
      "SELECT ShipperID, CompanyName, Phone FROM dbo.Shippers", _
      connection)

        ' Create a dependency and associate it with the SqlCommand.
        Dim dependency As New SqlDependency(command, notificationOptions, 0)
        ' Maintain the reference in a class member.
        ' Subscribe to the SqlDependency event.
        AddHandler dependency.OnChange, AddressOf OnDependencyChange

        ' Execute the command.
        Using reader = command.ExecuteReader()
            ' Process the DataReader.
        End Using
    End Using
End Sub

' Handler method
Sub OnDependencyChange(ByVal sender As Object, _
    ByVal e As SqlNotificationEventArgs)
    ' Handle the event (for example, invalidate this cache entry).
End Sub

Sub Termination()
    ' Release the dependency
    SqlDependency.Stop(connectionString, queueName)
End Sub
void Initialization()
{
    // Create a dependency connection.
    SqlDependency.Start(connectionString, queueName);
}

void SomeMethod()
{
    // Assume connection is an open SqlConnection.

    // Create a new SqlCommand object.
    using (SqlCommand command=new SqlCommand(
        "SELECT ShipperID, CompanyName, Phone FROM dbo.Shippers",
        connection))
    {

        // Create a dependency and associate it with the SqlCommand.
        SqlDependency dependency=new SqlDependency(command, notificationOptions, 0);
        // Maintain the reference in a class member.

        // Subscribe to the SqlDependency event.
        dependency.OnChange+=new
           OnChangeEventHandler(OnDependencyChange);

        // Execute the command.
        using (SqlDataReader reader = command.ExecuteReader())
        {
            // Process the DataReader.
        }
    }
}

// Handler method
void OnDependencyChange(object sender,
   SqlNotificationEventArgs e )
{
  // Handle the event (for example, invalidate this cache entry).
}

void Termination()
{
    // Release the dependency.
    SqlDependency.Stop(connectionString, queueName);
}

Consulte también