SocketAsyncEventArgs.BufferList Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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 .