See Also

TraceEventArgs Members  | Dart.PowerTCP.SslSockets Namespace

Requirements

Namespace: Dart.PowerTCP.SslSockets

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: Dart.PowerTCP.SslSockets (in Dart.PowerTCP.SslSockets.dll)

Language

Visual Basic

C#

C++

C++/CLI

Show All

See Also Requirements Languages PowerTCP SSL Sockets for .NET

TraceEventArgs Class

Dart.PowerTCP.SslSockets Namespace : TraceEventArgs Class

Provides data for the EndSend event which marks the completion of an asynchronous trace route operation.

For a list of all members of this type, see TraceEventArgs members.

Object Model


Inheritance Hierarchy

System.Object
   System.EventArgs
      Dart.PowerTCP.SslSockets.TraceEventArgs

Syntax

[Visual Basic]
Public Class TraceEventArgs    Inherits EventArgs
[C#]
public class TraceEventArgs : EventArgs
[C++]
public __gc class TraceEventArgs : public EventArgs
[C++/CLI]
public ref class TraceEventArgs : public EventArgs

Remarks

A TraceEventArgs object is passed as a parameter to all events that mark the completion of an asynchronous trace route operation. The Result property is a TraceResult object encapsulating data about the trace route operation.

If your code causes an exception, it would be returned to the handling event without you seeing it. To preclude such a condition, you should ALWAYS use a try/ catch block around your event-handling code.

Example

The following example demonstrates an asynchronous trace route operation.

[Visual Basic] 

Private Sub TraceTest()
   ' Set all hops and echoes to be synchronous
   Trace1.HopType = HopType.SynchHops

   ' Do not exceed 25 hops
   Trace1.MaxHops = 25

   ' Begin the trace route operation.
   Trace1.BeginSend("www.dart.com", Nothing)
End Sub

Private Sub Trace1_Hop(ByVal sender As Object, ByVal e As HopEventArgs) Handles Trace1.Hop
   ' Display information about the hop
   Debug.WriteLine("Time-to-live for the hop: " & e.Result.TTL)
   Debug.WriteLine("Remote address: " & e.Result.RemoteAddress)

   ' Now display info about each of the three echoes
   Debug.WriteLine("Response times for this hop")
   Dim er As EchoResult
   For Each er In e.Result.Echoes
      Debug.WriteLine(er.ResponseTime)
   Next

   Debug.WriteLine("Average time for this hop: " & e.Result.AverageTime)
End Sub

Private Sub Trace1_EndSend(ByVal sender As Object, ByVal e As TraceEventArgs) Handles Trace1.EndSend
   ' Check for any exceptions
   If e.Exception Is Nothing Then
      ' Trace operation is complete, display info.
      Debug.WriteLine("Total hops: " & e.Result.Hops.Length)
   Else
      Debug.WriteLine("Exception: " & e.Exception.Message)
   End If
End Sub

[C#] 


private void TraceTest()
{
  
// Set all hops and echoes to be synchronous
  
trace1.HopType = HopType.SynchHops;

  
// Do not exceed 25 hops
  
trace1.MaxHops = 25;

  
// Begin the trace route operation.
  
Trace1.BeginSend("www.dart.com", null);
}

private void trace1_Hop(object sender, HopEventArgs e)
{
  
// Display information about the hop
  
Debug.WriteLine("Time-to-live for the hop: " + e.Result.TTL);
  Debug.WriteLine(
"Remote address: " + e.Result.RemoteAddress);

  
// Now display info about each of the three echoes
  
Debug.WriteLine("Response times for this hop");
  
foreach(EchoResult er in e.Result.Echoes)
     Debug.WriteLine(er.ResponseTime);

  Debug.WriteLine(
"Average time for this hop: " + e.Result.AverageTime);
}

private void trace1_EndSend(object sender, TraceEventArgs e)
{
  
// Check for any exceptions
  
if(e.Exception == null)
     
// Trace operation completed successfully, display info.
     
Debug.WriteLine("Total hops: " + e.Result.Hops.Length);    
  
else
     
Debug.WriteLine("Exception: " + e.Exception.Message);
}
                

Requirements

Namespace: Dart.PowerTCP.SslSockets

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: Dart.PowerTCP.SslSockets (in Dart.PowerTCP.SslSockets.dll)

See Also

TraceEventArgs Members  | Dart.PowerTCP.SslSockets Namespace

 

Send comments on this topic.

Documentation version 1.1.2.0.

© 2008 Dart Communications.  All rights reserved.