SocketAsyncEventArgs.BufferList 屬性

定義

取得或設定要和非同步通訊端方法一起使用的資料緩衝區之陣列。

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,表示要和非同步通訊端方法一起使用的資料緩衝區之陣列。

例外狀況

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.ConnectAsyncSocket.AcceptAsync 方法會擲回 ArgumentException

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

適用於

另請參閱