SqlCacheDependencyAdmin.EnableTableForNotifications メソッド

定義

名前空間:
System.Web.Caching
アセンブリ:
System.Web.dll

SQL Server データベースに接続し、SqlCacheDependency 変更通知用にデータベース テーブルまたはテーブルを準備します。

オーバーロード

名前 説明
EnableTableForNotifications(String, String)

指定したSQL Server データベースに接続し、SqlCacheDependency 変更通知に対して指定されたデータベース テーブルを有効にします。
EnableTableForNotifications(String, String[])

指定したSQL Server データベースに接続し、SqlCacheDependency 変更通知に対して指定されたデータベース テーブルの配列を有効にします。

EnableTableForNotifications(String, String)

指定したSQL Server データベースに接続し、SqlCacheDependency 変更通知に対して指定されたデータベース テーブルを有効にします。

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)

パラメーター

connectionString
String

SQL Server データベースへの接続に使用する接続文字列。

table
String

変更通知を有効にするデータベース テーブル。

例外

DatabaseNotEnabledForNotificationException

データベースで変更通知が有効になっていません。

ArgumentNullException

table は nullです。

HttpException

データベースへの接続を確立できませんでした。

-または-

ASP.NET アプリケーションのセキュリティ コンテキストには、データベースに接続するためのアクセス許可がありません。

-または-

ASP.NET アプリケーションのセキュリティ コンテキストには、データベースの通知を無効にするアクセス許可がありません。

例

次のコード例では、EnableTableForNotifications メソッドを使用して、接続文字列 MyConnectionString で指定されたデータベース内の指定したテーブルに対する変更通知を有効にします。

この例を実行するために必要な完全なコードについては、「 SqlCacheDependencyAdmin クラスの概要」トピックの「例」セクションを参照してください。

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

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

注釈

EnableTableForNotifications メソッドは、table パラメーターで指定されたテーブルの変更通知を追加します。この通知は、connectionString パラメーターで指定されたデータベースに含まれている必要があります。

EnableTableForNotifications メソッドを使用して変更通知をテーブルに追加したら、変更通知を無効にする場合は、DisableTableForNotificationsオーバーロードのいずれかを使用する必要があります。

適用対象

EnableTableForNotifications(String, String[])

指定したSQL Server データベースに接続し、SqlCacheDependency 変更通知に対して指定されたデータベース テーブルの配列を有効にします。

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())

パラメーター

connectionString
String

SQL Server データベースへの接続に使用する接続文字列。

tables
String[]

変更通知を有効にするデータベース テーブルSQL Server配列。

例外

DatabaseNotEnabledForNotificationException

データベースで変更通知が有効になっていません。

ArgumentException

tables パラメーターの値の 1 つがnullです。

-または-

tables パラメーターの値の 1 つは空の文字列 ("") です。

ArgumentNullException

tables は nullです。

HttpException

データベースへの接続を確立できませんでした。

-または-

ASP.NET アプリケーションのセキュリティ コンテキストには、データベースに接続するためのアクセス許可がありません。

-または-

ASP.NET アプリケーションのセキュリティ コンテキストには、データベースの通知を無効にするアクセス許可がありません。

例

次のコード例では、EnableTableForNotifications メソッドを使用して、接続文字列 MyConnectionString で指定されたデータベースのセミコロン区切りリストで指定されたテーブルに対する変更通知を有効にします。

この例を実行するために必要な完全なコードについては、「 SqlCacheDependencyAdmin クラスの概要」トピックの「例」セクションを参照してください。

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

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

注釈

EnableTableForNotifications メソッドは、tables パラメーターで指定されたテーブルの変更通知を追加します。 これらのテーブルは、 connectionString パラメーターで指定されたデータベースに存在する必要があります。

EnableTableForNotifications メソッドを使用して変更通知をテーブルのグループに追加したら、変更通知を無効にする場合は、DisableTableForNotificationsオーバーロードのいずれかを使用する必要があります。

適用対象