TraceEvent Event

In This Topic

Occurs when DbMonitor object signals about some database activity.

Syntax

Visual Basic
C#

'Declaration
 
Public Event TraceEvent As MonitorEventHandler

public event MonitorEventHandler TraceEvent

Event Data

The event handler receives an argument of type MonitorEventArgs containing data related to this event. The following MonitorEventArgs properties provide information specific to this event.

Property	Description
CallStack	Gets the call stack of the monitor event.
Description	Gets the description of a DbMonitor event.
Duration	The time between the start and the end of the event.
EventType	Gets DbMonitor event type.
ExtraInfo	Gets the additional information for a DbMonitor event.
TracePoint	Determines whether TraceEvent event occurs before or after the operation takes place.

Example

The following sample shows how to enable and disable monitoring of database activity in your application.

csharp

static void OnEvent(object sender, MonitorEventArgs e)
{
  if (e.TracePoint==MonitorTracePoint.BeforeEvent)
  {
    Console.WriteLine("Description: " + e.Description);
    Console.WriteLine(" Extra info: " + e.ExtraInfo);
  }
}


[MTAThread]
static void Main(string[] args)
{
  SQLiteConnection sqConn = new SQLiteConnection(
      "DataSource=mydatabase.db;");
  SQLiteMonitor sqMonitor = new SQLiteMonitor();
  sqMonitor.TraceEvent += new MonitorEventHandler(OnEvent);
  sqMonitor.IsActive = true;
  SQLiteCommand sqCommand = new SQLiteCommand("select count(*) from Dept",sqConn);
  sqConn.Open();
  Console.WriteLine(sqCommand.ExecuteScalar());
  sqConn.Close();
  sqMonitor.TraceEvent -= new MonitorEventHandler(OnEvent);
  Console.ReadLine();
}

Visual Basic

Sub OnEvent(ByVal sender As Object, ByVal e As MonitorEventArgs)
  If e.TracePoint = MonitorTracePoint.BeforeEvent Then
    Console.WriteLine("Description: " & e.Description)
    Console.WriteLine(" Extra info: " & e.ExtraInfo)
  End If
End Sub

<MTAThread()> _
Sub Main()
  Dim sqConn As SQLiteConnection = New SQLiteConnection( _
      "DataSource=mydatabase.db;")
  Dim sqMonitor As SQLiteMonitor = New SQLiteMonitor
  AddHandler sqMonitor.TraceEvent, AddressOf OnEvent
  sqMonitor.IsActive = True
  Dim sqCommand As SQLiteCommand = New SQLiteCommand("select count(*) from Dept", sqConn)
  sqConn.Open()
  Console.WriteLine(sqCommand.ExecuteScalar())
  sqConn.Close()
  RemoveHandler sqMonitor.TraceEvent, AddressOf OnEvent
  Console.ReadLine()
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DbMonitor Class
DbMonitor Members

Send Feedback