PingOptions.Ttl Property

Reference

Definition

Namespace:: System.Net.NetworkInformation

Assemblies:: netstandard.dll, System.Net.Ping.dll

Assembly:: System.Net.Ping.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: PingOptions.cs

Source:: PingOptions.cs

Source:: PingOptions.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property int Ttl { int get(); void set(int value); };

public int Ttl { get; set; }

member this.Ttl : int with get, set

Public Property Ttl As Integer

Property Value

Int32

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

Exceptions

ArgumentOutOfRangeException

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

Examples

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 = gcnew PingOptions( 64,true );
Console::WriteLine( "Time to live: {0}", options->Ttl );
Console::WriteLine( "Don't fragment: {0}", options->DontFragment );

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

Remarks

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.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Share via