SocketAsyncEventArgs.BufferList Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает массив буферов данных для применения в асинхронном методе сокета.
public:
property System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ BufferList { System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ get(); void set(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ value); };
public System.Collections.Generic.IList<ArraySegment<byte>> BufferList { get; set; }
public System.Collections.Generic.IList<ArraySegment<byte>>? BufferList { get; set; }
member this.BufferList : System.Collections.Generic.IList<ArraySegment<byte>> with get, set
Public Property BufferList As IList(Of ArraySegment(Of Byte))
Значение свойства
Объект IList, представляющий массив буферов данных для применения в асинхронном методе сокета.
Исключения
Неоднозначное указание буферов для заданной операции. Это исключение возникает, если для свойства Buffer задано значение, отличное от NULL, и была предпринята попытка задать отличное от NULL значение для свойства BufferList.
Комментарии
Это свойство используется с методами Socket.ReceiveAsync и Socket.SendAsync .
Это свойство используется для предоставления нескольких буферов данных для отправки или для предоставления нескольких буферов для хранения полученных данных для асинхронной операции сокета, которая может отправлять или получать данные. Методы и Socket.SendAsync поддерживают Socket.ReceiveAsync несколько буферов, BufferList использующих свойство .
Если свойству BufferList присвоено значение, отличное от NULL, Buffer свойство должно иметь значение NULL и игнорироваться методами Socket.ReceiveAsync и Socket.SendAsync .
Если для Buffer параметра задано значение, отличное от NULL, и предпринята попытка задать BufferList свойству значение, отличное от NULL, возникает исключение.
Если свойству BufferList присвоено значение, отличное от NULL, Socket.ConnectAsync методы и Socket.AcceptAsync будут вызывать исключение ArgumentException.
Параметр BufferList игнорируется методами Socket.DisconnectAsync и Socket.SendPacketsAsync .