SqlCacheDependencyAdmin.EnableTableForNotifications Methode

Definition

Namespace:

System.Web.Caching

Assembly:

System.Web.dll

Stellt eine Verbindung mit einer SQL Server-Datenbank her und bereitet eine Datenbanktabelle oder -tabellen auf SqlCacheDependency-Änderungsbenachrichtigungen vor.

Überlädt

EnableTableForNotifications(String, String)	Stellt eine Verbindung mit der angegebenen SQL Server-Datenbank her und aktiviert die angegebene Datenbanktabelle für SqlCacheDependency-Änderungsbenachrichtigungen.
EnableTableForNotifications(String, String[])	Stellt eine Verbindung mit der angegebenen SQL Server-Datenbank her und aktiviert das angegebene Array von Datenbanktabellen für SqlCacheDependency-Änderungsbenachrichtigungen.

EnableTableForNotifications(String, String)

Stellt eine Verbindung mit der angegebenen SQL Server-Datenbank her und aktiviert die angegebene Datenbanktabelle für SqlCacheDependency-Änderungsbenachrichtigungen.

public:
 static void EnableTableForNotifications(System::String ^ connectionString, System::String ^ table);

public static void EnableTableForNotifications (string connectionString, string table);

static member EnableTableForNotifications : string * string -> unit

Public Shared Sub EnableTableForNotifications (connectionString As String, table As String)

Parameter

connectionString

String

Eine Verbindungszeichenfolge, die für den Verbindungsaufbau mit der SQL Server-Datenbank verwendet wird.

table

String

Die Datenbanktabelle, für die Änderungsbenachrichtigungen aktiviert werden sollen.

Ausnahmen

DatabaseNotEnabledForNotificationException

Die Datenbank ist nicht für Änderungsbenachrichtigungen aktiviert.

ArgumentNullException

table ist null.

HttpException

Es konnte keine Verbindung mit der Datenbank hergestellt werden.

- oder -

Der Sicherheitskontext der ASP.NET-Anwendung ist nicht zum Herstellen einer Verbindung mit der Datenbank berechtigt.

- oder -

Der Sicherheitskontext der ASP.NET-Anwendung ist nicht zum Deaktivieren von Benachrichtigungen für die Datenbank berechtigt.

Beispiele

Im folgenden Codebeispiel wird die EnableTableForNotifications Methode verwendet, um Änderungsbenachrichtigungen in der angegebenen Tabelle in der in der Verbindungszeichenfolge MyConnectionStringangegebenen Datenbank zu aktivieren.

Für den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" des SqlCacheDependencyAdmin Klassenübersichtsthemas.

SqlCacheDependencyAdmin.EnableTableForNotifications(
  ConfigurationManager.ConnectionStrings["MyConnectionString"].ConnectionString,
  tableName.Text);

SqlCacheDependencyAdmin.EnableTableForNotifications( _
  ConfigurationManager.ConnectionStrings("MyConnectionString").ConnectionString, _
  tableName.Text)

Hinweise

Die EnableTableForNotifications Methode fügt Änderungsbenachrichtigungen für die im Parameter angegebene Tabelle hinzu, die sich in der datenbank befinden muss, die im table connectionString Parameter angegeben ist.

Nachdem Sie die EnableTableForNotifications Methode zum Hinzufügen von Änderungsbenachrichtigungen zu einer Tabelle verwendet haben, müssen Sie eine der DisableTableForNotifications Überladungen verwenden, wenn Sie Änderungsbenachrichtigungen deaktivieren möchten.

EnableTableForNotifications(String, String[])

Stellt eine Verbindung mit der angegebenen SQL Server-Datenbank her und aktiviert das angegebene Array von Datenbanktabellen für SqlCacheDependency-Änderungsbenachrichtigungen.

public:
 static void EnableTableForNotifications(System::String ^ connectionString, cli::array <System::String ^> ^ tables);

public static void EnableTableForNotifications (string connectionString, string[] tables);

static member EnableTableForNotifications : string * string[] -> unit

Public Shared Sub EnableTableForNotifications (connectionString As String, tables As String())

Parameter

connectionString

String

Eine Verbindungszeichenfolge, die für den Verbindungsaufbau mit der SQL Server-Datenbank verwendet wird.

tables

String[]

Das Array von SQL Server-Datenbanktabellen, für das Änderungsbenachrichtigungen aktiviert werden sollen.

Ausnahmen

DatabaseNotEnabledForNotificationException

Die Datenbank ist nicht für Änderungsbenachrichtigungen aktiviert.

ArgumentException

Einer der Werte im tables-Parameter ist null.

- oder -

Einer der Werte im tables-Parameter ist eine leere Zeichenfolge ("").

ArgumentNullException

tables ist null.

HttpException

Es konnte keine Verbindung mit der Datenbank hergestellt werden.

- oder -

Der Sicherheitskontext der ASP.NET-Anwendung ist nicht zum Herstellen einer Verbindung mit der Datenbank berechtigt.

- oder -

Der Sicherheitskontext der ASP.NET-Anwendung ist nicht zum Deaktivieren von Benachrichtigungen für die Datenbank berechtigt.

Beispiele

Im folgenden Codebeispiel wird die Methode verwendet, um Änderungsbenachrichtigungen in den tabellen zu aktivieren, die EnableTableForNotifications in einer semikolon-getrennten Liste in der in der Verbindungszeichenfolge MyConnectionStringangegebenen Datenbank angegeben sind.

Für den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" des SqlCacheDependencyAdmin Klassenübersichtsthemas.

SqlCacheDependencyAdmin.EnableTableForNotifications(
  ConfigurationManager.ConnectionStrings["MyConnectionString"].ConnectionString,
  tableName.Text);

SqlCacheDependencyAdmin.EnableTableForNotifications( _
  ConfigurationManager.ConnectionStrings("MyConnectionString").ConnectionString, _
  tableName.Text)

Hinweise

Die EnableTableForNotifications Methode fügt Änderungsbenachrichtigungen für die tabellen hinzu, die im tables Parameter angegeben sind. Diese Tabellen müssen sich in der datenbank befinden, die im connectionString Parameter angegeben ist.

Nachdem Sie die EnableTableForNotifications Methode zum Hinzufügen von Änderungsbenachrichtigungen zu einer Gruppe von Tabellen verwendet haben, müssen Sie eine der DisableTableForNotifications Überladungen verwenden, wenn Sie Änderungsbenachrichtigungen deaktivieren möchten.