SqlTriggerContext Classe

Définition

Espace de noms:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Fournit des informations contextuelles à propos du déclencheur qui a été activé.

public ref class SqlTriggerContext sealed

public sealed class SqlTriggerContext

type SqlTriggerContext = class

Public NotInheritable Class SqlTriggerContext

Héritage

Object

SqlTriggerContext

Exemples

L’exemple suivant montre un SqlTriggerContext objet utilisé pour déterminer si une action s’est Insert produite. Si une ligne a été insérée dans la usertable de , le nom d’utilisateur et le nom réel sont récupérés à partir de la ligne insérée, puis ajoutés à la table UserNameAudit .

[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;
   }
}

<SqlTrigger(Name:="UsersAudit", Target:="[dbo].[users]", Event:="FOR INSERT")> _
Public Shared Sub UsersAudit()
        
   Dim command As SqlCommand
   Dim triggContext As SqlTriggerContext
   Dim reader As SqlDataReader
   Dim userName As String
   Dim realName As String

         
   ' Get the trigger context.
   triggContext = SqlContext.TriggerContext        

   Select Case triggContext.TriggerAction
           
      Case TriggerAction.Insert

         ' Retrieve the connection that the trigger is using.
         Using connection As 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 = CType(reader(0), String)
            realName = CType(reader(1), String)

            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()
                 
          End Using
         
   End Select

End Sub

Remarques

Les informations contextuelles fournies incluent le type d’action qui a provoqué le déclenchement du déclencheur, les colonnes qui ont été modifiées dans une opération UPDATE et, dans le cas d’un déclencheur en langage de définition de données (DDL), une structure EventData XML (voir Référence Transact-SQL) qui décrit l’opération de déclenchement.

Une instance de SqlTriggerContext est disponible à partir de la SqlContext classe, lorsque le code s’exécute à l’intérieur d’un déclencheur via la TriggerContext propriété .

Propriétés

ColumnCount	Obtient le nombre de colonnes contenues par la table de données liée au déclencheur. Cette propriété est en lecture seule.
EventData	Obtient les données d'événement spécifique à l'action qui a activé le déclencheur.
TriggerAction	Indique l'action qui a activé le déclencheur.

Méthodes

IsUpdatedColumn(Int32)

Retourne true si une colonne a été affectée par une instruction INSER ou UPDATE.