SqlCacheDependency クラス

リファレンス

定義

名前空間:: System.Web.Caching

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ASP.NET アプリケーションの Cache オブジェクトに格納されている項目と、特定の SQL Server データベーステーブルまたは SQL Server 2005 クエリ結果のいずれかとの間に、リレーションシップを確立します。このクラスは継承できません。

public ref class SqlCacheDependency sealed : System::Web::Caching::CacheDependency

public sealed class SqlCacheDependency : System.Web.Caching.CacheDependency

type SqlCacheDependency = class
    inherit CacheDependency

Public NotInheritable Class SqlCacheDependency
Inherits CacheDependency

継承: Object

CacheDependency
SqlCacheDependency

例

次のコード例では、 SqlDataSource コントロールと GridView コントロールを使用してデータベーステーブルを表示します。ページが読み込まれると、ページはオブジェクトの作成を SqlCacheDependency 試みます。オブジェクトが SqlCacheDependency 作成されると、ページはオブジェクトに依存する Cache 項目をに SqlCacheDependency 追加します。ここに示すような例外処理を使用する必要があります。

<%@ 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>

注釈

サポートされているすべてのバージョンの SQL Server (Microsoft SQL Server 7.0、Microsoft SQL Server 2000、および SQL Server 2005) SqlCacheDependency で、クラスは特定の SQL Server データベーステーブルを監視します。テーブルが変更されると、テーブルに関連付けられている項目がから Cache削除され、新しいバージョンの項目がに Cache追加されます。

クラスでは SqlCacheDependency 、SQL Server 2005 データベースを System.Data.SqlClient.SqlDependency 使用する場合のクラスとの統合もサポートされます。 SQL Server 2005 のクエリ通知メカニズムは、SQL クエリの結果を無効にし、SQL クエリに関連付けられているキャッシュされた項目をから削除するデータの変更を System.Web.Caching.Cache検出します。

クラスを SqlCacheDependency 使用すると、SQL Server データベーステーブルまたは SQL Server 2005 を使用する場合に SQL クエリに依存する項目をアプリケーション Cache に追加できます。このクラスをディレクティブと共 @ OutputCache に使用して、SQL Server データベーステーブルに依存する出力キャッシュページまたはユーザーコントロールを作成することもできます。最後に、クラスを page ディレクティブと共@ OutputCacheに使用SqlCacheDependencyして、SQL Server 2005 を使用する場合に、出力キャッシュされたページを SQL クエリの結果に依存させることができます。 SQL Server 2005 を使用したクエリ通知は、ユーザーコントロールのディレクティブでは @ OutputCache サポートされていません。

注意

テーブルベースの通知を使用するときにこのクラスを正しく機能させるには、依存関係を作成するデータベースとテーブルで通知が有効になっている必要があります。通知を有効にするには、クラスのメソッドを SqlCacheDependencyAdmin 呼び出すか、コマンドラインツールを aspnet_regsql.exe 使用します。さらに、適切な構成設定は、アプリケーションの Web.config ファイルに含まれている必要があります。

SqlCacheDependency SQL Server 2005 クエリ通知でオブジェクトを使用する場合、明示的な構成は必要ありません。クエリ通知の使用時に許可される Transact-SQL クエリの種類に関する制限については、SQL Server のドキュメントを参照してください。

次の例は、SQL Server データベーステーブルに対するテーブルベースの依存関係を有効にする ASP.NET Web.config ファイルを示しています。

<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>

コンストラクター

SqlCacheDependency(SqlCommand)	SqlCacheDependency クラスの新しいインスタンスを初期化し、指定されている SqlCommand を使用してキャッシュキーの依存関係を作成します。
SqlCacheDependency(String, String)	SqlCacheDependency クラスの新しいインスタンスを初期化し、指定されているパラメーターを使用してキャッシュキーの依存関係を作成します。

プロパティ

HasChanged	CacheDependency オブジェクトが変更されたかどうかを示す値を取得します。 (継承元 CacheDependency)
UtcLastModified	依存関係が最後に変更された時刻を取得します。 (継承元 CacheDependency)

メソッド

CreateOutputCacheDependency(String)	ASP.NET アプリケーションの OutputCache オブジェクトに格納されている項目と、SQL Server データベーステーブルとの間に依存関係を作成します。
DependencyDispose()	CacheDependency クラス、および CacheDependency から派生したクラスが使用したリソースを解放します。 (継承元 CacheDependency)
Dispose()	CacheDependency オブジェクトによって使用されているリソースを解放します。 (継承元 CacheDependency)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FinishInit()	CacheDependency オブジェクトの初期化を完了します。 (継承元 CacheDependency)
GetFileDependencies()	ファイルの依存関係を取得します。 (継承元 CacheDependency)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUniqueID()	SqlCacheDependency オブジェクトの一意の識別子を取得します。
ItemRemoved()	監視対象のキャッシュエントリが削除されるときに呼び出されます。 (継承元 CacheDependency)
KeepDependenciesAlive()	この項目に依存するすべてのキャッシュ項目の最終アクセス時刻を更新します。 (継承元 CacheDependency)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
NotifyDependencyChanged(Object, EventArgs)	派生クラス CacheDependency によって表される依存関係が変更されたことを、基本オブジェクトの CacheDependency に通知します。 (継承元 CacheDependency)
SetCacheDependencyChanged(Action<Object,EventArgs>)	変更において関係者への通知を処理するアクションメソッドをこの依存関係に追加します。 (継承元 CacheDependency)
SetUtcLastModified(DateTime)	依存関係が最後に変更された時刻にマークを付けます。 (継承元 CacheDependency)
TakeOwnership()	この依存関係の排他的所有権を宣言する最初のユーザーを許可します。 (継承元 CacheDependency)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

次の方法で共有

SqlCacheDependency クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース