SocketAsyncEventArgs.BufferList Eigenschaft

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Quelle:

SocketAsyncEventArgs.cs

Ruft ein Array von Datenpuffern ab, die mit einer asynchronen Socketmethode verwendet werden sollen, oder legt es fest.

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, set

Public Property BufferList As IList(Of ArraySegment(Of Byte))

Eigenschaftswert

IList<ArraySegment<Byte>>

Eine IList, die ein Array von Datenpuffern darstellt, die mit einer asynchronen Socketmethode verwendet werden sollen.

Ausnahmen

ArgumentException

Für einen set-Vorgang wurden 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 Methoden und Socket.SendAsync verwendet.

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

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

Wenn der Buffer wert auf einen Wert ungleich 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 - und Socket.AcceptAsync -Methode einen aus ArgumentException.

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

Weitere Informationen

• ReceiveAsync(SocketAsyncEventArgs)
• SendAsync(SocketAsyncEventArgs)
• Buffer