ServicePoint.UseNagleAlgorithm Property

Gets or sets a Boolean value that determines whether the Nagle algorithm is used on connections managed by this ServicePoint object.

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

public bool UseNagleAlgorithm { get; set; }
/** @property */
public boolean get_UseNagleAlgorithm ()

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

public function get UseNagleAlgorithm () : boolean

public function set UseNagleAlgorithm (value : boolean)

Not applicable.

Property Value

true to use the Nagle algorithm; otherwise, false. The default value is true.

The Nagle algorithm is used to buffer small packets of data and transmit them as a single packet. This process, referred to as "nagling," is widely used because it reduces the number of packets transmitted and lowers the overhead per packet.

Changing the value of this property does not affect existing connections. Only new connections created after the change are affected.

The Nagle algorithm is fully described in IETF RFC 896.

The following code example displays the value of this property.

Console.WriteLine ("UseNagleAlgorithm = " + sp.UseNagleAlgorithm.ToString ());
Console.WriteLine ("Expect 100-continue = " + sp.Expect100Continue.ToString ());

Console.WriteLine(("UseNagleAlgorithm = " 
    + System.Convert.ToString(sp.get_UseNagleAlgorithm())));
Console.WriteLine(("Expect 100-continue = " 
    + System.Convert.ToString(sp.get_Expect100Continue())));

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1