SocketAsyncEventArgs.BufferList プロパティ

定義

非同期ソケット メソッドで使用するデータ バッファーの配列を取得または設定します。

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

プロパティ値

IList<ArraySegment<Byte>>

非同期ソケット メソッドで使用するデータ バッファーの配列を表す IList

例外

設定操作であいまいなバッファーが指定されています。 この例外は、Buffer が null 以外の値に設定されている状態で、BufferList プロパティに null 以外の値を設定しようとした場合に発生します。

注釈

このプロパティは、メソッドとSocket.SendAsync共にSocket.ReceiveAsync使用されます。

このプロパティは、送信するデータの複数のバッファーを提供したり、データを送受信できる非同期ソケット操作の受信データを格納する複数のバッファーを提供するために使用されます。 プロパティを使用する複数のBufferListバッファーは、and Socket.SendAsync メソッドでSocket.ReceiveAsyncサポートされています。

プロパティが null 以外のBufferList値に設定されている場合、Bufferプロパティは null である必要があり、and Socket.SendAsync メソッドによってSocket.ReceiveAsync無視されます。

null 以外の Buffer 値に設定されていて、プロパティを null 以外の BufferList 値に設定しようとすると、例外がスローされます。

プロパティが null 以外の BufferList 値に設定されている場合、 Socket.ConnectAsync and Socket.AcceptAsync メソッドは ArgumentException.

パラメーターはBufferList、and Socket.SendPacketsAsync メソッドによってSocket.DisconnectAsync無視されます。

適用対象

こちらもご覧ください