SocketAsyncEventArgs.BufferList Propriedade

Definição

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

public System.Collections.Generic.IList<ArraySegment<byte>> BufferList { get; set; }
public System.Collections.Generic.IList<ArraySegment<byte>>? BufferList { get; set; }

Valor da propriedade

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

Exceções

Há buffers ambíguos especificados em uma operação de conjuntos. Essa exceção ocorre se a propriedade Buffer foi definida para um valor não nulo e foi feita uma tentativa de definir a propriedade BufferList como um valor não nulo.

Comentários

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

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. Vários buffers que usam a BufferList propriedade são compatíveis com os Socket.ReceiveAsync métodos e Socket.SendAsync .

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

Se o Buffer tiver sido definido como um valor não nulo e for feita uma tentativa de definir a BufferList propriedade como um valor não nulo, uma exceção será gerada.

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

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

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Confira também