SocketAsyncEventArgs.BufferList Egenskap

Definition

Hämtar eller anger en matris med databuffertar som ska användas med en asynkron socketmetod.

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

Egenskapsvärde

En IList som representerar en matris med databuffertar som ska användas med en asynkron socketmetod.

Undantag

Det finns tvetydiga buffertar som anges för en angiven åtgärd. Det här undantaget inträffar om Buffer egenskapen har angetts till ett värde som inte är null och ett försök gjordes att ange BufferList egenskapen till ett värde som inte är null.

Kommentarer

Den här egenskapen används med Socket.ReceiveAsync metoderna och Socket.SendAsync .

Den här egenskapen används för att tillhandahålla flera buffertar av data som ska skickas eller för att tillhandahålla flera buffertar där mottagna data kan lagras för en asynkron socketåtgärd som kan skicka eller ta emot data. Flera buffertar som använder BufferList egenskapen stöds av Socket.ReceiveAsync metoderna och Socket.SendAsync .

Om egenskapen BufferList är inställd på ett värde Buffer som inte är null måste egenskapen vara null och ignoreras av Socket.ReceiveAsync metoderna och Socket.SendAsync .

Om värdet Buffer har angetts till ett värde som inte är null och ett försök görs att ange BufferList egenskapen till ett värde som inte är null genereras ett undantag.

Om egenskapen BufferList är inställd på ett värde som inte är null utlöser Socket.ConnectAsync metoderna och Socket.AcceptAsync en ArgumentException.

Parametern BufferList ignoreras av Socket.DisconnectAsync metoderna och Socket.SendPacketsAsync .

Gäller för

Se även