SqlTriggerContext Clase

Definición

Espacio de nombres:

Microsoft.SqlServer.Server

Ensamblado:

System.Data.dll

Proporciona información contextual sobre el activador que se desencadenó.

public ref class SqlTriggerContext sealed

public sealed class SqlTriggerContext

type SqlTriggerContext = class

Public NotInheritable Class SqlTriggerContext

Herencia

Object

SqlTriggerContext

Ejemplos

En el ejemplo siguiente se muestra un SqlTriggerContext objeto que se usa para determinar si se ha producido una Insert acción. Si se insertó una fila en la usertabla de , el nombre de usuario y el nombre real se recuperan de la fila insertada y, a continuación, se agregan a la tabla 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

Comentarios

La información contextual proporcionada incluye el tipo de acción que provocó que el desencadenador se activara, qué columnas se modificaron en una operación UPDATE y, en el caso de un desencadenador de lenguaje de definición de datos (DDL), una estructura EventData XML (vea Referencia de Transact-SQL) que describe la operación de desencadenador.

Una instancia de está disponible en la SqlContext clase cuando el código se ejecuta dentro de SqlTriggerContext un desencadenador a través de la TriggerContext propiedad .

Propiedades

ColumnCount	Obtiene el número de columnas que contiene la tabla de datos enlazada al activador. Esta propiedad es de sólo lectura.
EventData	Obtiene los datos de evento específicos de la acción que desencadenó el activador.
TriggerAction	Indica qué acción desencadenó el activador.

Métodos

IsUpdatedColumn(Int32)

Devuelve true si una columna se ve afectada por una instrucción INSERT o UPDATE.