SocketAsyncEventArgs.BufferList Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een matrix van gegevensbuffers opgehaald of ingesteld voor gebruik met een asynchrone socketmethode.
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; }member this.BufferList : System.Collections.Generic.IList<ArraySegment<byte>> with get, setPublic Property BufferList As IList(Of ArraySegment(Of Byte))Waarde van eigenschap
Een IList matrix van gegevensbuffers die moeten worden gebruikt met een asynchrone socketmethode.
Uitzonderingen
Er zijn ambigu buffers opgegeven voor een setbewerking. Deze uitzondering treedt op als de Buffer eigenschap is ingesteld op een niet-null-waarde en er is geprobeerd de BufferList eigenschap in te stellen op een niet-null-waarde.
Opmerkingen
Deze eigenschap wordt gebruikt met de Socket.ReceiveAsync en Socket.SendAsync methoden.
Deze eigenschap wordt gebruikt om meerdere buffers aan gegevens te leveren die moeten worden verzonden of om meerdere buffers te bieden waarin ontvangen gegevens kunnen worden opgeslagen voor een asynchrone socketbewerking die gegevens kan verzenden of ontvangen. Meerdere buffers die gebruikmaken van de BufferList eigenschap worden ondersteund door de Socket.ReceiveAsync en Socket.SendAsync methoden.
Als de BufferList eigenschap is ingesteld op een niet-null-waarde, moet de Buffer eigenschap null zijn en worden genegeerd door de Socket.ReceiveAsync en Socket.SendAsync methoden.
Als de Buffer eigenschap is ingesteld op een niet-null-waarde en er wordt geprobeerd de BufferList eigenschap in te stellen op een niet-null-waarde, wordt er een uitzondering gegenereerd.
Als de BufferList eigenschap is ingesteld op een niet-null-waarde, genereert de Socket.ConnectAsync en Socket.AcceptAsync methoden een ArgumentException.
De BufferList parameter wordt genegeerd door de Socket.DisconnectAsync en Socket.SendPacketsAsync methoden.