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)

注釈

このメソッドは、パラメーターで指定されたテーブルの変更通知をtable追加します。この通知はEnableTableForNotifications、パラメーターで指定されたデータベースに存在する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 パラメーターのいずれかの値が null です。

• または -

tables パラメーターのいずれかの値が空の文字列 ("") です。

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 無効にする場合は、いずれかのオーバーロードを使用する必要があります。