Export (0) Print
Expand All

Socket.SendBufferSize Property

Gets or sets a value that specifies the size of the send buffer of the Socket.

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

'Declaration
Public Property SendBufferSize As Integer

Property Value

Type: System.Int32
An Int32 that contains the size, in bytes, of the send buffer. The default is 8192.

ExceptionCondition
SocketException

An error occurred when attempting to access the socket.

ObjectDisposedException

The Socket has been closed.

ArgumentOutOfRangeException

The value specified for a set operation is less than 0.

A larger buffer size might 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 SendBufferSize property.


		Private Shared Sub ConfigureTcpSocket(ByVal tcpSocket As Socket)
			' 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("")
		End Sub


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft