Język

Wykrywanie zmian za pomocą atrybutu SqlDependency

Aby wykryć, kiedy wyniki zapytania różnią się od pierwotnie pobranych, skojarz SqlDependency obiekt z SqlCommand obiektem przed wykonaniem polecenia. Zasubskrybuj zdarzenie OnChange, aby otrzymywać powiadomienie po zmianie wyników. Możesz również sprawdzić właściwość zależności HasChanges , aby określić, czy wyniki uległy zmianie.

Zagadnienia związane z zabezpieczeniami

Aby otrzymywać powiadomienia po zmianie danych bazowych, wywołaj metodę Start. Infrastruktura zależności otwiera SqlConnection dla odbiornika. Przyznaj podmiotowi zabezpieczeń bazy danych wymagane uprawnienia usługi Service Broker i powiadomień o zapytaniach. Zabezpieczenia dostępu do kodu nie są obsługiwane w nowoczesnym środowisku .NET. Aby uzyskać więcej informacji, zobacz Włączanie powiadomień o zapytaniach.

Przykład

Poniższe kroki ilustrują sposób deklarowania zależności, wykonywania polecenia i odbierania powiadomienia po zmianie zestawu wyników:

  1. Podczas inicjowania aplikacji wywołaj metodę SqlDependency.Start , aby uruchomić odbiornik klienta.

  2. Utwórz obiekty SqlConnection i SqlCommand w celu nawiązania połączenia z serwerem i zdefiniowania instrukcji Transact-SQL (T-SQL).

  3. Utwórz lub ponownie użyj obiekt SqlDependency i skojarz go z obiektem SqlCommand. Zależność tworzy i kojarzy SqlNotificationRequest obiekt z poleceniem zgodnie z potrzebami. Żądanie powiadomienia zawiera wewnętrzny identyfikator zależności. Konstruktor nie uruchamia odbiornika.

  4. Zarejestruj program obsługi zdarzeń w przypadku zdarzenia OnChange obiektu SqlDependency.

  5. Wykonaj polecenie przy użyciu jednej z jego Execute metod. Ponieważ polecenie zawiera żądanie powiadomienia, serwer rejestruje subskrypcję powiadomień dla określonej kolejki.

  6. Po zakończeniu działania aplikacji wywołaj SqlDependency.Stop przy użyciu tej samej nazwy parametry połączenia i kolejki.

Jeśli jakikolwiek użytkownik następnie zmieni dane bazowe, program Microsoft SQL Server wykryje, że istnieje powiadomienie oczekujące na taką zmianę, a następnie opublikuje powiadomienie, które jest przetwarzane i przekazywane do klienta za pośrednictwem bazowego SqlConnection , który został utworzony przez wywołanie metody SqlDependency.Start. Odbiornik klienta odbiera komunikat o unieważnieniu. Następnie odbiornik klienta lokalizuje skojarzony obiekt SqlDependency i uruchamia zdarzenie OnChange.

Poniższy fragment kodu przedstawia wzorzec projektowy przykładowej aplikacji. Zainstaluj pakiet NuGet Microsoft.Data.SqlClient i zaimportuj Microsoft.Data.SqlClient w języku C# lub Visual Basic.

Te fragmenty używają istniejącej kolejki usługi Service Broker. Ustaw queueName na niekwalifikowaną nazwę kolejki i notificationOptions na service=<service-name>;local database=<database-name>. Określ usługę, która kieruje powiadomienia do tej kolejki. Przekaż ten sam parametry połączenia i nazwę kolejki do Start i Stop. Aby uzyskać więcej informacji, zobacz Włączanie powiadomień o zapytaniach.

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);
}

Zobacz też