The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
Socket.ReceiveBufferSize Property
.NET Framework 3.0
Gets or sets a value that specifies the size of the receive buffer of the Socket.
Namespace: System.Net.Sockets
Assembly: System (in system.dll)
Assembly: System (in system.dll)
/** @property */ public int get_ReceiveBufferSize () /** @property */ public void set_ReceiveBufferSize (int value)
public function get ReceiveBufferSize () : int public function set ReceiveBufferSize (value : int)
Not applicable.
Property Value
An Int32 that contains the size, in bytes, of the receive buffer. The default is 8192.A larger buffer size potentially reduces the number of empty acknowledgements (TCP packets with no data portion), but might also delay the recognition of connection difficulties. Consider increasing the buffer size if you are transferring large files, or you are using a high bandwidth, high latency connection (such as a satellite broadband provider.)
The following code example demonstrates the use of the ReceiveBufferSize property.
static void ConfigureTcpSocket(Socket tcpSocket) { // Don't allow another socket to bind to this port. tcpSocket.ExclusiveAddressUse = true; // The socket will linger for 10 seconds after // Socket.Close is called. tcpSocket.LingerState = new LingerOption (true, 10); // Disable the Nagle Algorithm for this tcp socket. tcpSocket.NoDelay = true; // Set the receive buffer size to 8k tcpSocket.ReceiveBufferSize = 8192; // Set the timeout for synchronous receive methods to // 1 second (1000 milliseconds.) tcpSocket.ReceiveTimeout = 1000; // Set the send buffer size to 8k. tcpSocket.SendBufferSize = 8192; // Set the timeout for synchronous send methods // to 1 second (1000 milliseconds.) tcpSocket.SendTimeout = 1000; // Set the Time To Live (TTL) to 42 router hops. tcpSocket.Ttl = 42; Console.WriteLine("Tcp Socket configured:"); Console.WriteLine(" ExclusiveAddressUse {0}", tcpSocket.ExclusiveAddressUse); Console.WriteLine(" LingerState {0}, {1}", tcpSocket.LingerState.Enabled, tcpSocket.LingerState.LingerTime); Console.WriteLine(" NoDelay {0}", tcpSocket.NoDelay); Console.WriteLine(" ReceiveBufferSize {0}", tcpSocket.ReceiveBufferSize); Console.WriteLine(" ReceiveTimeout {0}", tcpSocket.ReceiveTimeout); Console.WriteLine(" SendBufferSize {0}", tcpSocket.SendBufferSize); Console.WriteLine(" SendTimeout {0}", tcpSocket.SendTimeout); Console.WriteLine(" Ttl {0}", tcpSocket.Ttl); Console.WriteLine(" IsBound {0}", tcpSocket.IsBound); Console.WriteLine(""); }
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.