Freigeben über


SocketAsyncEventArgs.BufferList Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Arrays von Datenpuffern, die mit einer asynchronen Socketmethode verwendet werden sollen.

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

Eigenschaftswert

Ein IList Array von Datenpuffern, die mit einer asynchronen Socketmethode verwendet werden sollen.

Ausnahmen

Für einen Set-Vorgang sind mehrdeutige Puffer angegeben. Diese Ausnahme tritt auf, wenn die Buffer Eigenschaft auf einen Wert ungleich Null festgelegt wurde und versucht wurde, die BufferList Eigenschaft auf einen Wert ungleich NULL festzulegen.

Hinweise

Diese Eigenschaft wird mit den Socket.ReceiveAsync Und Socket.SendAsync Methoden verwendet.

Diese Eigenschaft wird verwendet, um mehrere zu sendende Datenpuffer bereitzustellen oder mehrere Puffer bereitzustellen, in denen empfangene Daten für einen asynchronen Socketvorgang gespeichert werden, der Daten senden oder empfangen kann. Mehrere Puffer, die die BufferList Eigenschaft verwenden, werden von den und Socket.SendAsync den Socket.ReceiveAsync Methoden unterstützt.

Wenn die BufferList Eigenschaft auf einen Wert ungleich NULL festgelegt ist, muss die Buffer Eigenschaft null sein und von den Socket.ReceiveAsync Methoden Socket.SendAsync ignoriert werden.

Wenn die Buffer Eigenschaft auf einen Wert ohne Null festgelegt wurde und versucht wird, die BufferList Eigenschaft auf einen Wert ungleich Null festzulegen, wird eine Ausnahme ausgelöst.

Wenn die BufferList Eigenschaft auf einen Wert ungleich NULL festgelegt ist, löst die Socket.ConnectAsync Methode Socket.AcceptAsync einen ArgumentException.

Der BufferList Parameter wird von den Methoden und Socket.SendPacketsAsync den Socket.DisconnectAsync Methoden ignoriert.

Gilt für:

Weitere Informationen