Partilhar via


SocketAsyncEventArgs.BufferList Propriedade

Definição

Obtém ou define uma matriz de buffers de dados a serem usados com um método de soquete assíncrono.

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))

Valor da propriedade

Um IList que representa uma matriz de buffers de dados a ser usado com um método de soquete assíncrono.

Exceções

Há buffers ambíguos especificados em uma operação definida. Essa exceção ocorrerá se a Buffer propriedade tiver sido definida como um valor não nulo e uma tentativa de definir a BufferList propriedade como um valor não nulo.

Comentários

Essa propriedade é usada com os métodos e Socket.SendAsync os Socket.ReceiveAsync métodos.

Essa propriedade é usada para fornecer vários buffers de dados a serem enviados ou para fornecer vários buffers nos quais armazenar dados recebidos para uma operação de soquete assíncrona que pode enviar ou receber dados. Há suporte para vários buffers usando a BufferList propriedade e Socket.SendAsync métodosSocket.ReceiveAsync.

Se a BufferList propriedade for definida como um valor não nulo, a Buffer propriedade deverá ser nula e será ignorada pelos métodos e Socket.SendAsync pelos Socket.ReceiveAsync métodos.

Se o Buffer valor não nulo foi definido e uma tentativa é feita para definir a BufferList propriedade como um valor não nulo, uma exceção é gerada.

Se a BufferList propriedade estiver definida como um valor não nulo, os métodos e Socket.AcceptAsync os Socket.ConnectAsync métodos gerarão um ArgumentException.

O BufferList parâmetro é ignorado pelos métodos e Socket.SendPacketsAsync pelos Socket.DisconnectAsync métodos.

Aplica-se a

Confira também