MonitorEventHandler Delegate

In This Topic

Represents the method that will handle the TraceEvent event of the DbMonitor class.

Syntax

Visual Basic
C#

'Declaration
 
Public Delegate Sub MonitorEventHandler( _
   ByVal sender As Object, _
   ByVal e As MonitorEventArgs _
)

public delegate void MonitorEventHandler( 
   object sender,
   MonitorEventArgs e
)

Parameters

sender: The source of the event.
e: The MonitorEventArgs object that contains the event data.

Remarks

When you create a MonitorEventArgs delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler delegates, see "Events and Delegates" in the .NET Framework SDK documentation.

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)
{
  SqlConnection myConn = new SqlConnection(
      "User Id=sa;Server=localhost;Initial Catalog=Test;");
  SqlMonitor myMonitor = new SqlMonitor();
  myMonitor.TraceEvent += new MonitorEventHandler(OnEvent);
  myMonitor.IsActive = true;
  SqlCommand myCommand = new SqlCommand("select count(*) from Test.Dept",myConn);
  myConn.Open();
  Console.WriteLine(myCommand.ExecuteScalar());
  myConn.Close();
  myMonitor.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 myConn As SqlConnection = New SqlConnection( _
      "User Id=sa;Server=localhost;Initial Catalog=Test;")
  Dim myMonitor As SqlMonitor = New SqlMonitor
  AddHandler myMonitor.TraceEvent, AddressOf OnEvent
  myMonitor.IsActive = True
  Dim myCommand As SqlCommand = New SqlCommand("select count(*) from Test.Dept", myConn)
  myConn.Open()
  Console.WriteLine(myCommand.ExecuteScalar())
  myConn.Close()
  RemoveHandler myMonitor.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

MonitorEventHandler Members
Devart.Common Namespace

Send Feedback