SqlCacheDependencyAdmin.EnableTableForNotifications Método

Definición

Espacio de nombres:

System.Web.Caching

Ensamblado:

System.Web.dll

Establece una conexión a una base de datos de SQL Server y prepara una o varias tablas de base de datos para las notificaciones de cambios de SqlCacheDependency.

Sobrecargas

EnableTableForNotifications(String, String)	Establece una conexión a la base de datos de SQL Server especificada y habilita la tabla de base de datos especificada para las notificaciones de cambios de SqlCacheDependency.
EnableTableForNotifications(String, String[])	Establece una conexión a la base de datos de SQL Server especificada y habilita la matriz especificada de tablas de base de datos para las notificaciones de cambios de SqlCacheDependency.

EnableTableForNotifications(String, String)

Establece una conexión a la base de datos de SQL Server especificada y habilita la tabla de base de datos especificada para las notificaciones de cambios de 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)

Parámetros

connectionString

String

Cadena de conexión utilizada para la conexión con la base de datos de SQL Server.

table

String

Tabla de la base de datos donde se van a habilitar las notificaciones de cambios.

Excepciones

DatabaseNotEnabledForNotificationException

La base de datos no está habilitada para las notificaciones de cambios.

ArgumentNullException

table es null.

HttpException

No se pudo establecer una conexión con la base de datos.

o bien

El contexto de seguridad de la aplicación ASP.NET no tiene permiso para conectar con la base de datos.

o bien

El contexto de seguridad de la aplicación ASP.NET no tiene permiso para deshabilitar las notificaciones de la base de datos.

Ejemplos

En el ejemplo de código siguiente se usa el EnableTableForNotifications método para habilitar las notificaciones de cambio en la tabla especificada en la base de datos especificada en la cadena MyConnectionStringde conexión .

Para obtener el código completo necesario para ejecutar el ejemplo, vea la sección Ejemplo del tema de información general de la SqlCacheDependencyAdmin clase.

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

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

Comentarios

El EnableTableForNotifications método agrega notificaciones de cambio para la tabla especificada en el table parámetro , que debe estar en la base de datos especificada en el connectionString parámetro .

Una vez que haya usado el EnableTableForNotifications método para agregar notificaciones de cambio a una tabla, debe usar una de las DisableTableForNotifications sobrecargas si desea deshabilitar las notificaciones de cambio.

EnableTableForNotifications(String, String[])

Establece una conexión a la base de datos de SQL Server especificada y habilita la matriz especificada de tablas de base de datos para las notificaciones de cambios de 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())

Parámetros

connectionString

String

Cadena de conexión utilizada para la conexión con la base de datos de SQL Server.

tables

String[]

Matriz de tablas de base de datos de SQL Server donde se van a habilitar las notificaciones de cambios.

Excepciones

DatabaseNotEnabledForNotificationException

La base de datos no está habilitada para las notificaciones de cambios.

ArgumentException

Uno de los valores del parámetro tables es null.

o bien

Uno de los valores del parámetro tables es una cadena vacía ("").

ArgumentNullException

tables es null.

HttpException

No se pudo establecer una conexión con la base de datos.

o bien

El contexto de seguridad de la aplicación ASP.NET no tiene permiso para conectar con la base de datos.

o bien

El contexto de seguridad de la aplicación ASP.NET no tiene permiso para deshabilitar las notificaciones de la base de datos.

Ejemplos

En el ejemplo de código siguiente se usa el EnableTableForNotifications método para habilitar las notificaciones de cambio en las tablas especificadas en una lista delimitada por punto y coma en la base de datos especificada en la cadena MyConnectionStringde conexión .

Para obtener el código completo necesario para ejecutar el ejemplo, vea la sección Ejemplo del tema de información general de la SqlCacheDependencyAdmin clase.

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

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

Comentarios

El EnableTableForNotifications método agrega notificaciones de cambio para las tablas especificadas en el tables parámetro . Estas tablas deben estar en la base de datos especificada en el connectionString parámetro .

Una vez que haya usado el EnableTableForNotifications método para agregar notificaciones de cambio a un grupo de tablas, debe usar una de las DisableTableForNotifications sobrecargas si desea deshabilitar las notificaciones de cambio.