SqlCacheDependency コンストラクター

リファレンス

定義

名前空間:: System.Web.Caching

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

重要

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

SqlCacheDependency クラスの新しいインスタンスを初期化します。

オーバーロード

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

SqlCacheDependency(SqlCommand)

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

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

Public Sub New (sqlCmd As SqlCommand)

パラメーター

sqlCmd: SqlCommand

SqlCommand オブジェクトを作成するために使用する SqlCacheDependency。

例外

ArgumentNullException

sqlCmd パラメーターが null です。

HttpException

インスタンスの SqlCommand プロパティは NotificationAutoEnlist に設定され、属性が @ OutputCache にtrue設定されたディレクティブがページSqlDependencyに存在しますCommandNotification。

注釈

このコンストラクターは、SQL Server 2005 製品のクエリ通知機能を使用するオブジェクトを作成SqlCacheDependencyするために使用されます。

パラメーターに関連付 sqlCmd けられている SQL ステートメントには、次のものが含まれている必要があります。

テーブル所有者の名前を含む完全修飾テーブル名。たとえば、データベース所有者が所有する Customers という名前のテーブルを参照するには、SQL ステートメントでを参照する dbo.customers必要があります。
Select ステートメントの明示的な列名。アスタリスク (*) ワイルドカード文字を使用して、テーブルからすべての列を選択することはできません。たとえば、の select * from dbo.customers代わりにを使用 select name, address, city, state from dbo.customersする必要があります。

このコンストラクターを使用して、ページレベルの出力キャッシュをSqlCacheDependency使用して 2005 SQL Serverクエリ通知を使用して、インスタンスをページ上のインスタンスに関連付けSqlCommandることはできません。

こちらもご覧ください

SqlCacheDependency(String, String)

適用対象

SqlCacheDependency(String, String)

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

public:
 SqlCacheDependency(System::String ^ databaseEntryName, System::String ^ tableName);

public SqlCacheDependency (string databaseEntryName, string tableName);

new System.Web.Caching.SqlCacheDependency : string * string -> System.Web.Caching.SqlCacheDependency

Public Sub New (databaseEntryName As String, tableName As String)

パラメーター

databaseEntryName: String

アプリケーションの Web.config ファイルの databases 要素で定義されているデータベースの名前。

tableName: String

SqlCacheDependency が関連付けられているデータベーステーブルの名前。

例外

HttpException

SqlClientPermission の内部検証が失敗しました。

- または -

テーブルベースの通知用に設定されているデータベースの一覧に databaseEntryName がありませんでした。

- または -

初期化時に SqlCacheDependency オブジェクトをデータベースに接続できませんでした。

- または -

SqlCacheDependency オブジェクトをサポートするデータベースストアドプロシージャまたはデータベースのいずれかで、SqlCacheDependency オブジェクトが権限拒否エラーを検出しました。

ArgumentException

tableName パラメーターが Empty です。

ConfigurationErrorsException

SqlCacheDependency でポーリングが有効になっていません。

- または -

ポーリング間隔が正しく設定されていません。

- または -

アプリケーションの構成ファイルで接続文字列が指定されませんでした。

- または -

アプリケーションの構成ファイルで指定されている接続文字列が見つかりませんでした。

- または -

アプリケーションの構成ファイルで指定されている接続文字列が空の文字列です。

DatabaseNotEnabledForNotificationException

databaseEntryName パラメーターで指定されているデータベースの変更通知が有効になっていません。

TableNotEnabledForNotificationException

tableName パラメーターで指定されているデータベーステーブルの変更通知が有効になっていません。

ArgumentNullException

databaseEntryName が nullです。

または

tableName は null です。

例

次のコード例では、このコンストラクターを使用して、Northwind という名前のSqlCacheDependencySQL Server データベースに Categories という名前のデータベーステーブルに関連付けられているクラスのインスタンスを作成します。

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

注釈

このコンストラクターは、SQL Server 7.0 および SQL Server 2000 製品のオブジェクトを作成SqlCacheDependencyするために使用されます。

パラメーターに database 渡されるデータベース名は、アプリケーションの Web.config ファイルで定義する必要があります。たとえば、次のWeb.config ファイルでは、変更通知用に pubs という名前の SqlCacheDependency データベースを定義しています。

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

このコンストラクターを使用 DatabaseNotEnabledForNotificationException すると、一般的にと TableNotEnabledForNotificationExceptionの 2 つの例外がスローされます。 DatabaseNotEnabledForNotificationExceptionがスローされた場合は、例外処理コードでメソッドをSqlCacheDependencyAdmin.EnableNotifications呼び出すか、コマンドラインツールをaspnet_regsql.exe使用して通知用にデータベースを設定できます。 TableNotEnabledForNotificationExceptionがスローされた場合は、メソッドを呼び出すか、をSqlCacheDependencyAdmin.EnableTableForNotifications使用aspnet_regsql.exeして通知用のテーブルを設定できます。

こちらもご覧ください

SqlCacheDependency(SqlCommand)

適用対象

次の方法で共有

SqlCacheDependency コンストラクター

定義

オーバーロード

SqlCacheDependency(SqlCommand)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

SqlCacheDependency(String, String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース