SocketAsyncEventArgs.BufferList プロパティ

定義

非同期ソケット メソッドで使用するデータ バッファーの配列を取得または設定します。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; }
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>>

非同期ソケット メソッドで使用するデータ バッファーの配列を表す 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.

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

Bufferが null 以外の値に設定されていて、プロパティを null 以外の値に設定しようとした場合は、 BufferList 例外がスローされます。If 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.

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

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

適用対象

こちらもご覧ください