PingOptions.Ttl Property

Gets or sets the number of routing nodes that can forward the Ping data before it is discarded.

Namespace: System.Net.NetworkInformation
Assembly: System (in system.dll)

public:
property int Ttl {
	int get ();
	void set (int value);
}
/** @property */
public int get_Ttl ()

/** @property */
public void set_Ttl (int value)

public function get Ttl () : int

public function set Ttl (value : int)

Not applicable.

Property Value

An Int32 value that specifies the number of times the Ping data packets can be forwarded. The default is 128.

Exception typeCondition

ArgumentOutOfRangeException

The value specified for a set operation is less than or equal to zero.

As gateways and routers transmit packets through a network, they decrement the current Time-to-Live (TTL) value found in the packet header. If the TTL value reaches zero, the packet is deemed undeliverable and is discarded. This option is useful if you want to test the number of routers and gateways used to transmit the data.

The following code example demonstrates setting the value of this property using a PingOptions constructor, and then displaying the value.

// Set options for transmission:
// The data can go through 64 gateways or routers
// before it is destroyed, and the data packet
// cannot be fragmented.
PingOptions options = new PingOptions (64, true);

Console.WriteLine ("Time to live: {0}", options.Ttl);
Console.WriteLine ("Don't fragment: {0}", options.DontFragment);


Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: