SqlCacheDependencyAdmin.EnableTableForNotifications Método

Definição

Namespace:

System.Web.Caching

Assembly:

System.Web.dll

Conecta-se a um banco de dados do SQL Server e prepara a tabela (ou as tabelas) do banco de dados para as notificações de alteração SqlCacheDependency.

Sobrecargas

EnableTableForNotifications(String, String)	Conecta-se ao banco de dados do SQL Server especificado e habilita a tabela do banco de dados especificada para notificações de alteração SqlCacheDependency.
EnableTableForNotifications(String, String[])	Conecta-se ao banco de dados do SQL Server especificado e habilita a matriz especificada das tabelas do banco de dados para a notificação de alteração SqlCacheDependency.

EnableTableForNotifications(String, String)

Conecta-se ao banco de dados do SQL Server especificado e habilita a tabela do banco de dados especificada para notificações de alteração 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

Uma cadeia de conexão usada para se conectar ao banco de dados do SQL Server.

table

String

A tabela do tabela de banco de dados em que se habilitam as notificações de alteração.

Exceções

DatabaseNotEnabledForNotificationException

O banco de dados não está habilitado para notificações de alteração.

ArgumentNullException

table é null.

HttpException

Não foi possível estabelecer uma conexão com o banco de dados.

- ou -

O contexto de segurança do aplicativo ASP.NET não tem permissão para se conectar ao banco de dados.

- ou -

O contexto de segurança do aplicativo ASP.NET não tem permissão para desabilitar notificações para o banco de dados.

Exemplos

O exemplo de código a seguir usa o EnableTableForNotifications método para habilitar notificações de alteração na tabela especificada no banco de dados especificado na cadeia de conexão MyConnectionString.

Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico de visão geral da SqlCacheDependencyAdmin classe.

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

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

Comentários

O EnableTableForNotifications método adiciona notificações de alteração para a tabela especificada no table parâmetro, que deve estar no banco de dados especificado no connectionString parâmetro.

Depois de usar o EnableTableForNotifications método para adicionar notificações de alteração a uma tabela, você deverá usar uma das DisableTableForNotifications sobrecargas se quiser desabilitar as notificações de alteração.

EnableTableForNotifications(String, String[])

Conecta-se ao banco de dados do SQL Server especificado e habilita a matriz especificada das tabelas do banco de dados para a notificação de alteração 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

Uma cadeia de conexão usada para se conectar ao banco de dados do SQL Server.

tables

String[]

A matriz das tabelas do banco de dados do SQL Server em que se habilitam as notificações de alteração.

Exceções

DatabaseNotEnabledForNotificationException

O banco de dados não está habilitado para notificações de alteração.

ArgumentException

Um dos valores no parâmetro tables é null.

- ou -

Um dos valores no parâmetro tables é uma cadeia de caracteres vazia ("").

ArgumentNullException

tables é null.

HttpException

Não foi possível estabelecer uma conexão com o banco de dados.

- ou -

O contexto de segurança do aplicativo ASP.NET não tem permissão para se conectar ao banco de dados.

- ou -

O contexto de segurança do aplicativo ASP.NET não tem permissão para desabilitar notificações para o banco de dados.

Exemplos

O exemplo de código a seguir usa o EnableTableForNotifications método para habilitar notificações de alteração nas tabelas especificadas em uma lista delimitada por ponto e vírgula no banco de dados especificado na cadeia de conexão MyConnectionString.

Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico de visão geral da SqlCacheDependencyAdmin classe.

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

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

Comentários

O EnableTableForNotifications método adiciona notificações de alteração para as tabelas especificadas no tables parâmetro. Essas tabelas devem estar no banco de dados especificado no connectionString parâmetro.

Depois de usar o EnableTableForNotifications método para adicionar notificações de alteração a um grupo de tabelas, você deverá usar uma das DisableTableForNotifications sobrecargas se quiser desabilitar as notificações de alteração.