SocketAsyncEventArgs.BufferList 屬性

定義

命名空間:

System.Net.Sockets

組件:

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

Set 作業指定了不明確的緩衝區。 如果 Buffer 屬性設定成非 Null 值，且嘗試將 BufferList 屬性設定為非 Null 值，就會發生這個例外狀況。

備註

這個屬性會與 和 Socket.SendAsync 方法搭配Socket.ReceiveAsync使用。

這個屬性可用來提供要傳送的多個數據緩衝區，或提供多個緩衝區，以便針對可傳送或接收數據的異步套接字作業儲存接收的數據。 和 Socket.SendAsync 方法支援Socket.ReceiveAsync使用 BufferList 屬性的多個緩衝區。

BufferList如果屬性設定為非 Null 值，則 Buffer 屬性必須是 Null，而且 和 Socket.SendAsync 方法會忽略Socket.ReceiveAsync。

Buffer如果 已設定為非 Null 值，且嘗試將 屬性設定BufferList為非 Null 值，則會擲回例外狀況。

BufferList如果屬性設定為非 Null 值，Socket.ConnectAsync和 Socket.AcceptAsync 方法會擲回 ArgumentException。

BufferList和 Socket.SendPacketsAsync 方法會Socket.DisconnectAsync忽略 參數。

另請參閱

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