PingOptions.DontFragment Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a Boolean value that controls fragmentation of the data sent to the remote host.

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

public bool DontFragment { get; set; }

Property Value

Type: System.Boolean

true if the data cannot be sent in multiple packets; otherwise false. The default is false.

Applications use this property to control whether data sent to a remote host by the Ping class can be divided into multiple packets. This option is useful if you want to test the maximum transmission unit (MTU) of the routers and gateways used to transmit the packet. If this property is true and the data sent to the remote host is larger then the MTU of a gateway or router between the sender and the remote host, the ping operation fails with status PacketTooBig.

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
Available since 2.0
Return to top