SqlTriggerContext Klasse

Definition

Namespace:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Stellt Kontextinformationen über den ausgelösten Trigger bereit.

public ref class SqlTriggerContext sealed

public sealed class SqlTriggerContext

type SqlTriggerContext = class

Public NotInheritable Class SqlTriggerContext

Vererbung

Object

SqlTriggerContext

Beispiele

Das folgende Beispiel zeigt ein SqlTriggerContext Objekt, das verwendet wird, um zu bestimmen, ob eine Insert Aktion aufgetreten ist. Wenn eine Zeile in die userTabelle 's eingefügt wurde, werden der Benutzername und der reale Name aus der eingefügten Zeile abgerufen und dann der Tabelle UserNameAudit hinzugefügt.

[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

Hinweise

Die bereitgestellten Kontextinformationen umfassen den Typ der Aktion, durch die der Trigger ausgelöst wurde, welche Spalten in einem UPDATE-Vorgang geändert wurden, und im Fall eines DDL-Triggers (Data Definition Language) eine XML EventData-Struktur (siehe Transact-SQL-Referenz), die den auslösenden Vorgang beschreibt.

Ein instance von SqlTriggerContext ist in der SqlContext -Klasse verfügbar, wenn der Code in einem Trigger über die TriggerContext -Eigenschaft ausgeführt wird.

Eigenschaften

ColumnCount	Ruft die Anzahl der Spalten in der an den Trigger gebundenen Datentabelle ab. Diese Eigenschaft ist schreibgeschützt.
EventData	Ruft die Ereignisdaten für eine bestimmte Aktion ab, die den Trigger ausgelöst hat.
TriggerAction	Gibt an, welche Aktion den Trigger ausgelöst hat.

Methoden

IsUpdatedColumn(Int32)

Gibt true zurück, wenn eine Spalte bei einer INSERT-Anweisung oder einer UPDATE-Anweisung geändert wurde.