Export (0) Print
Expand All

SocketAsyncEventArgs.BufferList Property

Gets or sets an array of data buffers to use with an asynchronous socket method.

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

public IList<ArraySegment<byte>> BufferList { get; set; }

Property Value

Type: System.Collections.Generic.IList<ArraySegment<Byte>>
An System.Collections.IList that represents an array of data buffers to use with an asynchronous socket method.

ExceptionCondition
ArgumentException

There are ambiguous buffers specified on a set operation. This exception occurs if a value other than null is passed and the Buffer property is also not null.

This property is used with the Socket.ReceiveAsync and Socket.SendAsync methods.

This property is used to provide multiple buffers of data to be sent or to provide multiple buffers in which to store received data for an asynchronous socket operation that can send or receive data. Multiple buffers are supported by the Socket.ReceiveAsync and Socket.SendAsync methods.

If the BufferList property is set to a non-null value, the Buffer property must be null and is ignored by the Socket.ReceiveAsync and Socket.SendAsync methods.

If the Buffer was set to a non-null value and an attempt is made to set the BufferList property to a non-null value, an exception is thrown.

If the BufferList property is set to a non-null value, the Socket.ConnectAsync and Socket.AcceptAsync methods will throw an ArgumentException.

The BufferList parameter is ignored by the Socket.DisconnectAsync and Socket.SendPacketsAsync methods.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

.NET Framework

Supported in: 3.5 SP1, 3.0 SP1, 2.0 SP1

Community Additions

ADD
Show:
© 2014 Microsoft