Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

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 int Ttl { get; set; }

Property Value

Type: System.Int32
An Int32 value that specifies the number of times the Ping data packets can be forwarded. The default is 128.
ExceptionCondition
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);

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.