SocketAsyncEventArgs.BufferList プロパティ

  • リファレンス

定義

名前空間:
System.Net.Sockets
アセンブリ:
System.dll, System.Net.Sockets.dll
アセンブリ:
System.Net.Sockets.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll
ソース:
SocketAsyncEventArgs.cs
ソース:
SocketAsyncEventArgs.cs
ソース:
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; }
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.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無視されます。

適用対象

こちらもご覧ください