PingOptions.DontFragment Property
Definition
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 a Boolean value that controls fragmentation of the data sent to the remote host.
public:
property bool DontFragment { bool get(); void set(bool value); };public bool DontFragment { get; set; }member this.DontFragment : bool with get, setPublic Property DontFragment As BooleanProperty Value
true if the data cannot be sent in multiple packets; otherwise false. The default is false.
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
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.
