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)
{
  BigcommerceConnection bigcommerceConn = new BigcommerceConnection(
      "Server=https://bigcommerce-store.mybigcommerce.com/api/v2/;User Id=User;Authentication Token=qweASDzcx1234567890rtyuiqweASDzcx1234567;");
  BigcommerceMonitor bigcommerceMonitor = new BigcommerceMonitor();
  bigcommerceMonitor.TraceEvent += new MonitorEventHandler(OnEvent);
  bigcommerceMonitor.IsActive = true;
  BigcommerceCommand bigcommerceCommand = new BigcommerceCommand("select count(*) from customers",bigcommerceConn);
  bigcommerceConn.Open();
  Console.WriteLine(bigcommerceCommand.ExecuteScalar());
  bigcommerceConn.Close();
  bigcommerceMonitor.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 bigcommerceConn As BigcommerceConnection = New BigcommerceConnection( _
      "Server=https://bigcommerce-store.mybigcommerce.com/api/v2/;User Id=User;Authentication Token=qweASDzcx1234567890rtyuiqweASDzcx1234567;")
  Dim bigcommerceMonitor As BigcommerceMonitor = New BigcommerceMonitor
  AddHandler bigcommerceMonitor.TraceEvent, AddressOf OnEvent
  bigcommerceMonitor.IsActive = True
  Dim bigcommerceCommand As BigcommerceCommand = New BigcommerceCommand("select count(*) from customers", bigcommerceConn)
  bigcommerceConn.Open()
  Console.WriteLine(bigcommerceCommand.ExecuteScalar())
  bigcommerceConn.Close()
  RemoveHandler bigcommerceMonitor.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