SqlCacheDependency Classe
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.
Stabilisce una relazione tra un elemento archiviato in un oggetto Cache di un'applicazione ASP.NET e una tabella di database di SQL Server specifica oppure i risultati di una query di SQL Server 2005. La classe non può essere ereditata.
public ref class SqlCacheDependency sealed : System::Web::Caching::CacheDependencypublic sealed class SqlCacheDependency : System.Web.Caching.CacheDependencytype SqlCacheDependency = class
inherit CacheDependencyPublic NotInheritable Class SqlCacheDependency
Inherits CacheDependency- Ereditarietà
Esempio
Nell'esempio di codice seguente vengono utilizzati i SqlDataSource controlli e GridView per visualizzare una tabella di database. Quando la pagina viene caricata, la pagina tenta di creare un SqlCacheDependency oggetto . Dopo aver creato l'oggetto SqlCacheDependency , la pagina aggiunge un elemento a Cache con una dipendenza dall'oggetto SqlCacheDependency . È consigliabile usare la gestione delle eccezioni simile a quella illustrata qui.
<%@ Page Language="C#" Debug="true" %>
<%@ import Namespace="System.Data.SqlClient" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet2>
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.";
}
}
// </snippet2>
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<p>
</p>
<p>
<asp:SqlDataSource id="Source1" runat="server" SelectCommand="SELECT * FROM [Categories]" UpdateCommand="UPDATE [Categories] SET [CategoryName]=@CategoryName,[Description]=@Description,[Picture]=@Picture WHERE [CategoryID]=@CategoryID" ConnectionString="<%$ ConnectionStrings:Northwind %>"></asp:SqlDataSource>
<asp:GridView id="GridView1" runat="server" DataKeyNames="CategoryID" AllowSorting="True" AllowPaging="True" DataSourceID="Source1"></asp:GridView>
</p>
<p>
</p>
<p>
<asp:Label id="CacheMsg" runat="server" AssociatedControlID="GridView1"></asp:Label>
</p>
</form>
</body>
</html>
<%@ Page Language="VB" Debug="True" %>
<%@ import Namespace="System.Data.SqlClient" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' <snippet2>
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
' </snippet2>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<p>
</p>
<p>
<asp:SqlDataSource id="Source1" runat="server" SelectCommand="SELECT * FROM [Categories]" UpdateCommand="UPDATE [Categories] SET [CategoryName]=@CategoryName,[Description]=@Description,[Picture]=@Picture WHERE [CategoryID]=@CategoryID" ConnectionString="<%$ ConnectionStrings:Northwind %>"></asp:SqlDataSource>
<asp:GridView id="GridView1" runat="server" DataKeyNames="CategoryID" AllowSorting="True" AllowPaging="True" DataSourceID="Source1"></asp:GridView>
</p>
<p>
</p>
<p>
<asp:Label id="CacheMsg" runat="server" AssociatedControlID="GridView1"></asp:Label>
</p>
</form>
</body>
</html>
Commenti
In tutte le versioni supportate di SQL Server (Microsoft SQL Server 7.0, Microsoft SQL Server 2000 e SQL Server 2005) la SqlCacheDependency classe monitora una tabella di database di SQL Server specifica. Quando la tabella viene modificata, gli elementi associati alla tabella vengono rimossi da Cachee una nuova versione dell'elemento viene aggiunta a Cache.
La SqlCacheDependency classe supporta anche l'integrazione con la System.Data.SqlClient.SqlDependency classe quando si usa un database di SQL Server 2005. Il meccanismo di notifica delle query di SQL Server 2005 rileva le modifiche ai dati che invalidano i risultati di una query SQL e rimuove tutti gli elementi memorizzati nella cache associati alla query SQL da System.Web.Caching.Cache.
È possibile usare la SqlCacheDependency classe per aggiungere elementi alle applicazioni Cache dipendenti da una tabella di database di SQL Server o da una query SQL quando si usa SQL Server 2005. È anche possibile usare questa classe con la @ OutputCache direttiva per rendere una pagina memorizzata nella cache di output o un controllo utente dipendente da una tabella di database di SQL Server. Infine, è possibile usare la classe con la SqlCacheDependency@ OutputCache direttiva page per rendere una pagina memorizzata nella cache di output in base ai risultati di una query SQL quando si usa SQL Server 2005. La notifica di query che usa SQL Server 2005 non è supportata nella direttiva per i @ OutputCache controlli utente.
Nota
Affinché questa classe funzioni correttamente quando si usano notifiche basate su tabelle, il database e tutte le tabelle su cui si desidera creare dipendenze devono essere abilitate le notifiche. È possibile abilitare le notifiche chiamando i metodi della SqlCacheDependencyAdmin classe o tramite lo aspnet_regsql.exe strumento da riga di comando. Inoltre, le impostazioni di configurazione appropriate devono essere incluse nel file di Web.config dell'applicazione.
L'uso di un SqlCacheDependency oggetto con la notifica di query di SQL Server 2005 non richiede alcuna configurazione esplicita. Consultare la documentazione di SQL Server per informazioni sulle restrizioni relative ai tipi di query Transact-SQL consentite quando si usa la notifica di query.
Nell'esempio seguente viene illustrato un file di ASP.NET Web.config che abilita le dipendenze basate su tabelle in una tabella di database di SQL Server.
<configuration>
<connectionStrings>
<add name="Northwind" connectionString="Data Source=(local); Initial Catalog=northwind; Integrated Security=true"; providerName="System.Data.SqlClient" />
</connectionStrings>
<system.web>
<caching>
<sqlCacheDependency enabled = "true" pollTime = "60000" >
<databases>
<add name="northwind"
connectionStringName="Northwind"
pollTime="9000000"
/>
</databases>
</sqlCacheDependency>
</caching>
</system.web>
</configuration>
Costruttori
| 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. |
Proprietà
| HasChanged |
Ottiene un valore che indica se l'oggetto CacheDependency è stato modificato. (Ereditato da CacheDependency) |
| UtcLastModified |
Ottiene l'ora dell'ultima modifica apportata alla dipendenza. (Ereditato da CacheDependency) |
Metodi
| CreateOutputCacheDependency(String) |
Crea una relazione di dipendenza tra un elemento archiviato in un oggetto OutputCache di un'applicazione ASP.NET e una tabella di database di SQL Server. |
| DependencyDispose() |
Rilascia le risorse utilizzate dalla classe CacheDependency e tutte le classi che derivano da CacheDependency. (Ereditato da CacheDependency) |
| Dispose() |
Rilascia le risorse usate dall'oggetto CacheDependency. (Ereditato da CacheDependency) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FinishInit() |
Completa l'inizializzazione dell'oggetto CacheDependency. (Ereditato da CacheDependency) |
| GetFileDependencies() |
Ottiene le dipendenze del file. (Ereditato da CacheDependency) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueID() |
Recupera un identificatore univoco per un oggetto SqlCacheDependency. |
| ItemRemoved() |
Chiamato quando viene rimossa una voce della cache monitorata. (Ereditato da CacheDependency) |
| KeepDependenciesAlive() |
Aggiorna l'ora dell'ultimo accesso di ogni elemento della cache che dipende da questo elemento. (Ereditato da CacheDependency) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| NotifyDependencyChanged(Object, EventArgs) |
Notifica all'oggetto CacheDependency di base che sono state apportate modifiche alla dipendenza rappresentata da una classe CacheDependency derivata. (Ereditato da CacheDependency) |
| SetCacheDependencyChanged(Action<Object,EventArgs>) |
Aggiunge un metodo azione per gestire l'invio delle notifiche alle parti interessate delle modifiche apportate a questa dipendenza. (Ereditato da CacheDependency) |
| SetUtcLastModified(DateTime) |
Indica l'ora dell'ultima modifica apportata a una dipendenza. (Ereditato da CacheDependency) |
| TakeOwnership() |
Consente al primo utente di dichiarare la proprietà esclusiva di questa dipendenza. (Ereditato da CacheDependency) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
