英語で読む

次の方法で共有


SqlTriggerContext クラス

定義

発生したトリガーに関する文脈情報を提供します。

C#
public sealed class SqlTriggerContext
継承
SqlTriggerContext

次の例は、アクションが SqlTriggerContext 発生したかどうかを判断するために使用されているオブジェクトを Insert 示しています。 のテーブルに user行が挿入された場合、挿入された行からユーザー名と実際の名前が取得され、 UserNameAudit テーブルに追加されます。

C#
[SqlTrigger(Name = @"UsersAudit", Target = "[dbo].[users]", Event = "FOR INSERT")]
public static void UsersAudit()
{
   // Get the trigger context.
   string userName;
   string realName;
   SqlCommand command;
   SqlTriggerContext triggContext = SqlContext.TriggerContext;
   SqlDataReader reader;

   switch (triggContext.TriggerAction)
   {
      case TriggerAction.Insert:

      // Retrieve the connection that the trigger is using.
      using (SqlConnection connection
         = new SqlConnection(@"context connection=true"))
      {
         connection.Open();

         // Get the inserted row.
         command = new SqlCommand(@"SELECT * FROM INSERTED;",
                                  connection);

         // Get the user name and real name of the inserted user.
         reader = command.ExecuteReader();
         reader.Read();
         userName = (string)reader[0];
         realName = (string)reader[1];
         reader.Close();

         // Insert the user name and real name into the auditing table.
         command = new SqlCommand(@"INSERT [dbo].[UserNameAudit] (userName, realName) "
                  + @"VALUES (@userName, @realName);", connection);

         command.Parameters.Add(new SqlParameter("@userName", userName));
         command.Parameters.Add(new SqlParameter("@realName", realName));

         command.ExecuteNonQuery();
      }

      break;
   }
}

注釈

提供されるコンテキスト情報には、トリガーが起動する原因となったアクションの種類、UPDATE 操作で変更された列、およびデータ定義言語 (DDL) トリガーの場合は、トリガー操作を記述する XML EventData 構造体 ( Transact-SQL リファレンスを参照) が含まれます。

のインスタンス SqlTriggerContext は、 プロパティを SqlContext 介して TriggerContext トリガー内でコードが実行されている場合に、 クラスから使用できます。

プロパティ

ColumnCount

トリガーにバインドされたデータ テーブルに含まれる列数を取得します。 このプロパティは読み取り専用です。

EventData

トリガーの発生源となったアクションに固有のイベント データを取得します。

TriggerAction

トリガーの発生源となったアクションを示します。

メソッド

IsUpdatedColumn(Int32)

列が INSERT ステートメントまたは UPDATE ステートメントによって変更されていた場合、true を返します。

適用対象

製品 バージョン
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1