This documentation is archived and is not being maintained.

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)

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 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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, 1.1
Show: