SqlCacheDependency Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe SqlCacheDependency.
Overload
| SqlCacheDependency(SqlCommand) |
Inizializza una nuova istanza della classe SqlCacheDependency utilizzando l'oggetto SqlCommand fornito per creare una dipendenza di chiave di cache. |
| SqlCacheDependency(String, String) |
Inizializza una nuova istanza della classe SqlCacheDependency utilizzando i parametri forniti per creare una dipendenza di chiave di cache. |
SqlCacheDependency(SqlCommand)
Inizializza una nuova istanza della classe SqlCacheDependency utilizzando l'oggetto SqlCommand fornito per creare una dipendenza di chiave di cache.
public:
SqlCacheDependency(System::Data::SqlClient::SqlCommand ^ sqlCmd);public SqlCacheDependency (System.Data.SqlClient.SqlCommand sqlCmd);new System.Web.Caching.SqlCacheDependency : System.Data.SqlClient.SqlCommand -> System.Web.Caching.SqlCacheDependencyPublic Sub New (sqlCmd As SqlCommand)Parametri
- sqlCmd
- SqlCommand
Classe SqlCommand utilizzata per creare un oggetto SqlCacheDependency.
Eccezioni
Il valore del parametro sqlCmd è null.
L'istanza SqlCommand ha la proprietà NotificationAutoEnlist impostata su true e nella pagina è presente una @ OutputCache direttiva con l'attributo SqlDependency impostato su CommandNotification.
Commenti
Questo costruttore viene usato per creare SqlCacheDependency oggetti che usano la funzionalità di notifica delle query dei prodotti SQL Server 2005.
Le istruzioni SQL associate al sqlCmd parametro devono includere quanto segue:
Nomi di tabella completi, incluso il nome del proprietario della tabella. Ad esempio, per fare riferimento a una tabella denominata Customers di proprietà del proprietario del database, l'istruzione SQL deve fare riferimento a
dbo.customers.Nomi di colonna espliciti nell'istruzione Select. Non è possibile utilizzare il carattere jolly asterisco (*) per selezionare tutte le colonne di una tabella. Ad esempio, anziché
select * from dbo.customers, è necessario usareselect name, address, city, state from dbo.customers.
Questo costruttore non può essere usato per associare un'istanza SqlCommand a un'istanza SqlCacheDependency di in una pagina utilizzando SQL Server 2005 notifiche di query con la memorizzazione nella cache dell'output a livello di pagina.
Vedi anche
Si applica a
SqlCacheDependency(String, String)
Inizializza una nuova istanza della classe SqlCacheDependency utilizzando i parametri forniti per creare una dipendenza di chiave di cache.
public:
SqlCacheDependency(System::String ^ databaseEntryName, System::String ^ tableName);public SqlCacheDependency (string databaseEntryName, string tableName);new System.Web.Caching.SqlCacheDependency : string * string -> System.Web.Caching.SqlCacheDependencyPublic Sub New (databaseEntryName As String, tableName As String)Parametri
- databaseEntryName
- String
Nome di un database definito nell'elemento databases del file Web.config dell'applicazione.
- tableName
- String
Nome della tabella di database a cui è associata la classe SqlCacheDependency.
Eccezioni
La verifica interna dell'oggetto SqlClientPermission non è riuscita.
-oppure-
Il parametro databaseEntryName non è stato trovato nell'elenco di database configurato per le notifiche basate su tabella.
-oppure-
Non è stato possibile connettere l'oggetto SqlCacheDependency al database durante l'inizializzazione.
-oppure-
L'oggetto SqlCacheDependency ha rilevato un errore di autorizzazione negata nel database o nelle stored procedure di database che supportano l'oggetto SqlCacheDependency.
Il valore del parametro tableName è Empty.
Il polling non è attivato per la classe SqlCacheDependency.
-oppure-
L'intervallo di polling non è stato configurato correttamente.
-oppure-
Non è stata specificata alcuna stringa di connessione nel file di configurazione dell'applicazione.
-oppure-
Non è stato possibile trovare la stringa di connessione specificata nel file di configurazione dell'applicazione.
-oppure-
La stringa di connessione specificata nel file di configurazione dell'applicazione è una stringa vuota.
Il database specificato nel parametro databaseEntryName non è attivato per le notifiche di modifica.
La tabella di database specificata nel parametro tableName non è attivata per le notifiche di modifica.
Esempio
Nell'esempio di codice seguente viene utilizzato questo costruttore per creare un'istanza della SqlCacheDependency classe associata a una tabella di database denominata Categories in un database SQL Server denominato Northwind.
public void Page_Load(object Src, EventArgs E)
{
// Declare the SqlCacheDependency instance, SqlDep.
SqlCacheDependency SqlDep = null;
// Check the Cache for the SqlSource key.
// If it isn't there, create it with a dependency
// on a SQL Server table using the SqlCacheDependency class.
if (Cache["SqlSource"] == null) {
// Because of possible exceptions thrown when this
// code runs, use Try...Catch...Finally syntax.
try {
// Instantiate SqlDep using the SqlCacheDependency constructor.
SqlDep = new SqlCacheDependency("Northwind", "Categories");
}
// Handle the DatabaseNotEnabledForNotificationException with
// a call to the SqlCacheDependencyAdmin.EnableNotifications method.
catch (DatabaseNotEnabledForNotificationException exDBDis) {
try {
SqlCacheDependencyAdmin.EnableNotifications("Northwind");
}
// If the database does not have permissions set for creating tables,
// the UnauthorizedAccessException is thrown. Handle it by redirecting
// to an error page.
catch (UnauthorizedAccessException exPerm) {
Response.Redirect(".\\ErrorPage.htm");
}
}
// Handle the TableNotEnabledForNotificationException with
// a call to the SqlCacheDependencyAdmin.EnableTableForNotifications method.
catch (TableNotEnabledForNotificationException exTabDis) {
try {
SqlCacheDependencyAdmin.EnableTableForNotifications("Northwind", "Categories");
}
// If a SqlException is thrown, redirect to an error page.
catch (SqlException exc) {
Response.Redirect(".\\ErrorPage.htm");
}
}
// If all the other code is successful, add MySource to the Cache
// with a dependency on SqlDep. If the Categories table changes,
// MySource will be removed from the Cache. Then generate a message
// that the data is newly created and added to the cache.
finally {
Cache.Insert("SqlSource", Source1, SqlDep);
CacheMsg.Text = "The data object was created explicitly.";
}
}
else {
CacheMsg.Text = "The data was retrieved from the Cache.";
}
}
Sub Page_Load(Src As Object, E As EventArgs)
' Declare the SqlCacheDependency instance, SqlDep.
Dim SqlDep As SqlCacheDependency
' Check the Cache for the SqlSource key.
' If it isn't there, create it with a dependency
' on a SQL Server table using the SqlCacheDependency class.
If Cache("SqlSource") Is Nothing
' Because of possible exceptions thrown when this
' code runs, use Try...Catch...Finally syntax.
Try
' Instantiate SqlDep using the SqlCacheDependency constructor.
SqlDep = New SqlCacheDependency("Northwind", "Categories")
' Handle the DatabaseNotEnabledForNotificationException with
' a call to the SqlCacheDependencyAdmin.EnableNotifications method.
Catch exDBDis As DatabaseNotEnabledForNotificationException
Try
SqlCacheDependencyAdmin.EnableNotifications("Northwind")
' If the database does not have permissions set for creating tables,
' the UnauthorizedAccessException is thrown. Handle it by redirecting
' to an error page.
Catch exPerm As UnauthorizedAccessException
Response.Redirect(".\ErrorPage.htm")
End Try
' Handle the TableNotEnabledForNotificationException with
' a call to the SqlCacheDependencyAdmin.EnableTableForNotifications method.
Catch exTabDis As TableNotEnabledForNotificationException
Try
SqlCacheDependencyAdmin.EnableTableForNotifications( _
"Northwind", "Categories")
' If a SqlException is thrown, redirect to an error page.
Catch exc As SqlException
Response.Redirect(".\ErrorPage.htm")
End Try
' If all the other code is successful, add MySource to the Cache
' with a dependency on SqlDep. If the Categories table changes,
' MySource will be removed from the Cache. Then generate a message
' that the data is newly created and added to the cache.
Finally
Cache.Insert("SqlSource", Source1, SqlDep)
CacheMsg.Text = "The data object was created explicitly."
End Try
Else
CacheMsg.Text = "The data was retrieved from the Cache."
End If
End Sub
Commenti
Questo costruttore viene usato per creare SqlCacheDependency oggetti per SQL Server 7.0 e SQL Server 2000 prodotti.
Il nome del database passato al database parametro deve essere definito nel file di Web.config dell'applicazione. Ad esempio, il file di Web.config seguente definisce un database denominato pubs per SqlCacheDependency le notifiche di modifica.
<configuration>
<connectionStrings>
<add name="Pubs" connectionString="Data Source=(local); Initial Catalog=pubs; Integrated Security=true"; providerName="System.Data.SqlClient" />
</connectionStrings>
<system.web>
<caching>
<sqlCacheDependency enabled = "true" pollTime = "60000" >
<databases>
<add name="pubs"
connectionStringName="pubs"
pollTime="9000000"
/>
</databases>
</sqlCacheDependency>
</caching>
</system.web>
</configuration>
Quando viene usato questo costruttore, vengono comunemente generate due eccezioni: DatabaseNotEnabledForNotificationException e TableNotEnabledForNotificationException. Se viene generata un'eccezione DatabaseNotEnabledForNotificationException , è possibile chiamare il SqlCacheDependencyAdmin.EnableNotifications metodo nel codice di gestione delle eccezioni oppure usare lo aspnet_regsql.exe strumento da riga di comando per configurare il database per le notifiche. Se viene generata un'eccezione TableNotEnabledForNotificationException , è possibile chiamare il SqlCacheDependencyAdmin.EnableTableForNotifications metodo o usare aspnet_regsql.exe per configurare la tabella per le notifiche.
