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

例外

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

注釈

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

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

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

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

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

パラメーターはBufferList、 メソッドと Socket.SendPacketsAsync メソッドではSocket.DisconnectAsync無視されます。

適用対象

こちらもご覧ください