Export (0) Print
Expand All

SqlCacheDependencyAdmin.EnableTableForNotifications Method (String, String[])

Connects to the specified SQL Server database and enables the specified array of database tables for SqlCacheDependency change notification.

Namespace:  System.Web.Caching
Assembly:  System.Web (in System.Web.dll)

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

Parameters

connectionString
Type: System.String
A connection string used to connect to the SQL Server database.
tables
Type: System.String[]
The array of SQL Server database tables on which to enable change notifications.

ExceptionCondition
DatabaseNotEnabledForNotificationException

The database is not enabled for change notifications.

ArgumentException

One of the values in the tables parameter is null.

-or-

One of the values in the tables parameter is an empty string ("").

ArgumentNullException

tables is null.

HttpException

A connection to the database could not be established.

-or-

The security context of the ASP.NET application does not have permission to connect to the database.

-or-

The security context of the ASP.NET application does not have permission to disable notifications for the database.

The EnableTableForNotifications method adds change notifications for the tables specified in the tables parameter. These tables must be in the database specified in the connectionString parameter.

Once you have used the EnableTableForNotifications method to add change notifications to a group of tables, you must use one of the DisableTableForNotifications overloads if you wish to disable change notifications.

The following code example uses the EnableTableForNotifications method to enable change notifications on the tables specified in a semicolon-delimited list in the database specified in the connection string MyConnectionString.

For the full code required to run the example, see the Example section of the SqlCacheDependencyAdmin class overview topic.


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


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft