SocketAsyncEventArgs.BufferList プロパティ

定義

名前空間:

System.Net.Sockets

アセンブリ:

netstandard.dll, System.Net.Sockets.dll

ソース:

SocketAsyncEventArgs.cs

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

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

プロパティ値

IList<ArraySegment<Byte>>

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

例外

ArgumentException

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

注釈

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

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

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

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

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

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

こちらもご覧ください

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