SocketAsyncEventArgs.BufferList SocketAsyncEventArgs.BufferList SocketAsyncEventArgs.BufferList SocketAsyncEventArgs.BufferList Property

定義

非同期ソケット メソッドで使用するデータ バッファーの配列を取得または設定します。Gets or sets an array of data buffers to use with an asynchronous socket method.

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

プロパティ値

非同期ソケット メソッドで使用するデータ バッファーの配列を表す IListAn IList that represents an array of data buffers to use with an asynchronous socket method.

例外

設定操作であいまいなバッファーが指定されています。There are ambiguous buffers specified on a set operation. この例外は、Buffer が null 以外の値に設定されている状態で、BufferList プロパティに null 以外の値を設定しようとした場合に発生します。This exception occurs if the Buffer property has been set to a non-null value and an attempt was made to set the BufferList property to a non-null value.

注釈

このプロパティは、メソッドSocket.ReceiveAsyncおよびSocket.SendAsyncメソッドで使用されます。This property is used with the Socket.ReceiveAsync and Socket.SendAsync methods.

このプロパティは、送信されるデータの複数のバッファーを提供したり、データを送受信できる非同期ソケット操作の受信データを格納する複数のバッファーを提供したりするために使用されます。This property is used to provide multiple buffers of data to be sent or to provide multiple buffers in which to store received data for an asynchronous socket operation that can send or receive data. BufferListプロパティを使用する複数のバッファーは、 Socket.ReceiveAsyncメソッドSocket.SendAsyncとメソッドでサポートされています。Multiple buffers using the BufferList property are supported by the Socket.ReceiveAsync and Socket.SendAsync methods.

プロパティが null 以外の値に設定されている場合Buffer 、プロパティは null にする必要がありSocket.ReceiveAsyncSocket.SendAsyncメソッドとメソッドでは無視されます。 BufferListIf the BufferList property is set to a non-null value, the Buffer property must be null and is ignored by the Socket.ReceiveAsync and Socket.SendAsync methods.

が null 以外の値に設定されていて、 BufferListプロパティを null 以外の値に設定しようとした場合は、例外がスローされます。 BufferIf the Buffer was set to a non-null value and an attempt is made to set the BufferList property to a non-null value, an exception is thrown.

プロパティが null 以外の値に設定されている場合Socket.ConnectAsyncSocket.AcceptAsyncメソッドArgumentExceptionとメソッドはをスローします。 BufferListIf the BufferList property is set to a non-null value, the Socket.ConnectAsync and Socket.AcceptAsync methods will throw an ArgumentException.

パラメーターは、メソッドSocket.DisconnectAsyncSocket.SendPacketsAsyncメソッドでは無視されます。 BufferListThe BufferList parameter is ignored by the Socket.DisconnectAsync and Socket.SendPacketsAsync methods.

適用対象

こちらもご覧ください