This documentation is archived and is not being maintained.

PingOptions.DontFragment Property

Note: This property is new in the .NET Framework version 2.0.

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)

property bool DontFragment {
	bool get ();
	void set (bool value);
/** @property */
public boolean get_DontFragment ()

/** @property */
public void set_DontFragment (boolean value)

public function get DontFragment () : boolean

public function set DontFragment (value : boolean)

Property Value

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

Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0