See Also

Trace Class  | Trace Members

Requirements

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

Language

Visual Basic

C#

C++

C++/CLI

Show All

See Also Languages PowerTCP SSL Sockets for .NET

MaxHops Property

Dart.PowerTCP.SslSockets Namespace > Trace Class : MaxHops Property

Gets and sets the maximum number of hops to take when attempting to reach a host.

[Visual Basic]
<DescriptionAttribute("Gets or Sets a value that controls the maximum number of hops a TraceRoute will take.")> <DefaultValueAttribute()> <CategoryAttribute("Behavior")> Public Property MaxHops As Integer
[C#]
[DescriptionAttribute("Gets or Sets a value that controls the maximum number of hops a TraceRoute will take.")] [DefaultValueAttribute()] [CategoryAttribute("Behavior")] public int MaxHops {get; set;}
[C++]
[DescriptionAttribute("Gets or Sets a value that controls the maximum number of hops a TraceRoute will take.")] [DefaultValueAttribute()] [CategoryAttribute("Behavior")] public: __property int get_MaxHops(); public: __property void set_MaxHops(    int value );
[C++/CLI]
[DescriptionAttribute("Gets or Sets a value that controls the maximum number of hops a TraceRoute will take.")] [DefaultValueAttribute()] [CategoryAttribute("Behavior")] public: property int MaxHops {    int get();    void set (int value); }

Return Type

An integer value representing the maximum number of hops to take. Defaults to 30.

Remarks

This property specifies the maximum number of hops to take when attempting to reach a host. Set this property higher if the host is not reached in the default amount of hops (30).

Example

The following example demonstrates a basic 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

   ' Trace the route. Trace.Hop event will be raised when new hop data is available
   Dim tr As TraceResult = Trace1.Send("www.dart.com")

   ' Trace route complete. Display some data.
   Debug.WriteLine("Average time for final hop: " & tr.AverageTime)
   Debug.WriteLine("Number of hops: " & tr.Hops.Length)
   Debug.WriteLine("Remote Address: " & tr.RemoteAddress)
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

[C#] 


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

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

  
// Trace the route. Trace.Hop event will be raised when new hop data is available
  
TraceResult tr = trace1.Send("www.dart.com");

  
// Trace route complete. Display some data.
  
Debug.WriteLine("Average time for final hop: " + tr.AverageTime);
  Debug.WriteLine(
"Number of hops: " + tr.Hops.Length);
  Debug.WriteLine(
"Remote Address: " + tr.RemoteAddress);
}

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);
}
                

Requirements

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

See Also

Trace Class  | Trace Members


Send comments on this topic.

Documentation version 1.1.2.0.

© 2008 Dart Communications.  All rights reserved.