SocketAsyncEventArgs.BufferList Propriété

Définition

Obtient ou définit un tableau de la mémoire tampon de données à utiliser avec une méthode de socket asynchrone.

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

Valeur de propriété

IList qui représente un tableau de mémoires tampons de données à utiliser avec une méthode de socket asynchrone.

Exceptions

Des mémoires tampon ambiguës sont spécifiées sur une opération ensembliste. Cette exception se produit si la propriété Buffer a eu une valeur non NULL et une tentative a été faite pour affecter à la propriété BufferList une valeur non NULL.

Remarques

Cette propriété est utilisée avec les Socket.ReceiveAsync méthodes et Socket.SendAsync .

Cette propriété est utilisée pour fournir plusieurs mémoires tampons de données à envoyer ou pour fournir plusieurs mémoires tampons dans lesquelles stocker les données reçues pour une opération de socket asynchrone qui peut envoyer ou recevoir des données. Plusieurs mémoires tampons utilisant la BufferList propriété sont prises en charge par les Socket.ReceiveAsync méthodes et Socket.SendAsync .

Si la BufferList propriété est définie sur une valeur non null, la Buffer propriété doit être null et est ignorée par les Socket.ReceiveAsync méthodes et Socket.SendAsync .

Si a Buffer été défini sur une valeur non null et qu’une tentative est effectuée pour affecter à la BufferList propriété une valeur non null, une exception est levée.

Si la BufferList propriété est définie sur une valeur non null, les Socket.ConnectAsync méthodes et Socket.AcceptAsync lèvent un ArgumentException.

Le BufferList paramètre est ignoré par les Socket.DisconnectAsync méthodes et Socket.SendPacketsAsync .

S’applique à

Voir aussi