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

예제

다음 코드 예제에서는 및 GridView 컨트롤을 사용하여 SqlDataSource 데이터베이스 테이블을 표시합니다. 페이지가 로드되면 페이지가 개체를 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 2005를 사용할 때 SQL Server 데이터베이스 테이블 또는 SQL 쿼리에 종속된 항목을 애플리케이션 Cache 에 추가할 수 있습니다. 이 클래스를 @ OutputCache 지시문과 함께 사용하여 출력 캐시된 페이지 또는 SQL Server 데이터베이스 테이블에 종속된 사용자 컨트롤을 만들 수도 있습니다. 마지막으로, 페이지 지시문과 함께 @ 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 클래스

정의

예제

설명

생성자

속성

메서드

적용 대상

추가 정보

추가 리소스