PingOptions.DontFragment Property

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

Namespace:  System.Net.NetworkInformation
Assemblies:   System.Net.NetworkInformation (in System.Net.NetworkInformation.dll)
  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

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2014 Microsoft