SendPacketsElement 建構函式

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

初始化 SendPacketsElement 類別的新執行個體。

多載

SendPacketsElement(Byte[])	使用指定的緩衝區，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(String, Int64, Int32, Boolean)	使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。
SendPacketsElement(String, Int32, Int32, Boolean)	使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。
SendPacketsElement(Byte[], Int32, Int32, Boolean)	使用指定的緩衝區範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。
SendPacketsElement(String, Int64, Int32)	使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(String, Int32, Int32)	使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(FileStream, Int64, Int32, Boolean)	使用指定的 FileStream 物件範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。
SendPacketsElement(Byte[], Int32, Int32)	使用指定的緩衝區範圍，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(ReadOnlyMemory<Byte>, Boolean)	使用指定的緩衝區與選項，將類別的新實例 SendPacketsElement 初始化，以將這個專案與從套接字層傳送至傳輸的單一傳送要求中的下一個項目結合。
SendPacketsElement(String)	使用指定的檔案，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(ReadOnlyMemory<Byte>)	使用指定的緩衝區，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(FileStream)	使用指定的 FileStream 物件，初始化 SendPacketsElement 類別的新執行個體。
SendPacketsElement(FileStream, Int64, Int32)	使用指定的 FileStream 物件範圍，初始化 SendPacketsElement 類別的新執行個體。

SendPacketsElement(Byte[])

來源:

SendPacketsElement.cs

使用指定的緩衝區，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(cli::array <System::Byte> ^ buffer);

public SendPacketsElement (byte[] buffer);

new System.Net.Sockets.SendPacketsElement : byte[] -> System.Net.Sockets.SendPacketsElement

Public Sub New (buffer As Byte())

參數

buffer

Byte[]

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳送之資料的位元組陣列。

例外狀況

ArgumentNullException

buffer 參數不可以是 Null。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

另請參閱

• ArgumentNullException
• SendPacketsAsync(SocketAsyncEventArgs)
• SendPacketsElements

SendPacketsElement(String, Int64, Int32, Boolean)

來源:

SendPacketsElement.cs

使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。

public:
 SendPacketsElement(System::String ^ filepath, long offset, int count, bool endOfPacket);

public SendPacketsElement (string filepath, long offset, int count, bool endOfPacket);

new System.Net.Sockets.SendPacketsElement : string * int64 * int * bool -> System.Net.Sockets.SendPacketsElement

Public Sub New (filepath As String, offset As Long, count As Integer, endOfPacket As Boolean)

參數

filepath

String

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸之檔案的檔名。

offset

Int64

位移 (以位元組為單位)，從檔案的開頭到 filepath 參數中指定開始傳送檔案的位置。

count

Int32

從 offset 參數開始，要傳送的位元組數目。 如果 count 為零，就會傳送整個檔案。

endOfPacket

Boolean

指定不應該將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。 這個旗標可用來更精細地控制資料包上或訊息導向通訊端上每個訊息的內容。

例外狀況

ArgumentNullException

filepath 參數不可為 null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

參數支援 filepath 通用命名慣例 (UNC) 路徑。 如果檔案位於目前的工作目錄中，則不需要指定路徑資訊。

SendPacketsElement(String, Int32, Int32, Boolean)

來源:

SendPacketsElement.cs

使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。

public:
 SendPacketsElement(System::String ^ filepath, int offset, int count, bool endOfPacket);

public SendPacketsElement (string filepath, int offset, int count, bool endOfPacket);

new System.Net.Sockets.SendPacketsElement : string * int * int * bool -> System.Net.Sockets.SendPacketsElement

Public Sub New (filepath As String, offset As Integer, count As Integer, endOfPacket As Boolean)

參數

filepath

String

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸之檔案的檔名。

offset

Int32

位移 (以位元組為單位)，從檔案的開頭到 filepath 參數中指定開始傳送檔案的位置。

count

Int32

從 offset 參數開始，要傳送的位元組數目。 如果 count 為零，就會傳送整個檔案。

endOfPacket

Boolean

布林值，指定這個元素是否要和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。 這個旗標可用來更精細地控制資料包上或訊息導向通訊端上每個訊息的內容。

例外狀況

ArgumentNullException

filepath 參數不可以是 Null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

參數支援 filepath 通用命名慣例 (UNC) 路徑。 如果檔案位於目前的工作目錄中，則不需要指定路徑資訊。

另請參閱

• ArgumentNullException
• ArgumentOutOfRangeException
• SendPacketsAsync(SocketAsyncEventArgs)
• SendPacketsElements

SendPacketsElement(Byte[], Int32, Int32, Boolean)

來源:

SendPacketsElement.cs

使用指定的緩衝區範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。

public:
 SendPacketsElement(cli::array <System::Byte> ^ buffer, int offset, int count, bool endOfPacket);

public SendPacketsElement (byte[] buffer, int offset, int count, bool endOfPacket);

new System.Net.Sockets.SendPacketsElement : byte[] * int * int * bool -> System.Net.Sockets.SendPacketsElement

Public Sub New (buffer As Byte(), offset As Integer, count As Integer, endOfPacket As Boolean)

參數

buffer

Byte[]

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳送之資料的位元組陣列。

offset

Int32

位移 (以位元組為單位)，從 buffer 的開頭到 buffer 中的位置 (buffer 參數中指定開始傳送資料的位置)。

count

Int32

從 offset 參數開始要傳送的位元組數目。 如果 count 為零，就不會傳送任何位元組。

endOfPacket

Boolean

布林值，指定這個元素是否要和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。 這個旗標可用來更精細地控制資料包上或訊息導向通訊端上每個訊息的內容。

例外狀況

ArgumentNullException

buffer 參數不可以是 Null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

offset和 count 必須小於緩衝區的大小。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

另請參閱

• ArgumentNullException
• ArgumentOutOfRangeException
• SendPacketsAsync(SocketAsyncEventArgs)
• SendPacketsElements

SendPacketsElement(String, Int64, Int32)

來源:

SendPacketsElement.cs

使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(System::String ^ filepath, long offset, int count);

public SendPacketsElement (string filepath, long offset, int count);

new System.Net.Sockets.SendPacketsElement : string * int64 * int -> System.Net.Sockets.SendPacketsElement

Public Sub New (filepath As String, offset As Long, count As Integer)

參數

filepath

String

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸之檔案的檔名。

offset

Int64

位移 (以位元組為單位)，從檔案的開頭到 filepath 參數中指定開始傳送檔案的位置。

count

Int32

從 offset 開始，要傳送的位元組數。 如果 count 為零，就會傳送整個檔案。

例外狀況

ArgumentNullException

filepath 參數不可為 null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

參數支援 filepath 通用命名慣例 (UNC) 路徑。 如果檔案位於目前的工作目錄中，則不需要指定路徑資訊。

SendPacketsElement(String, Int32, Int32)

來源:

SendPacketsElement.cs

使用指定的檔案範圍，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(System::String ^ filepath, int offset, int count);

public SendPacketsElement (string filepath, int offset, int count);

new System.Net.Sockets.SendPacketsElement : string * int * int -> System.Net.Sockets.SendPacketsElement

Public Sub New (filepath As String, offset As Integer, count As Integer)

參數

filepath

String

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸之檔案的檔名。

offset

Int32

位移 (以位元組為單位)，從檔案的開頭到 filepath 參數中指定開始傳送檔案的位置。

count

Int32

從 offset 參數開始，要傳送的位元組數目。 如果 count 為零，就會傳送整個檔案。

例外狀況

ArgumentNullException

filepath 參數不可以是 Null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

參數支援 filepath 通用命名慣例 (UNC) 路徑。 如果檔案位於目前的工作目錄中，則不需要指定路徑資訊。

另請參閱

• ArgumentNullException
• ArgumentOutOfRangeException
• SendPacketsAsync(SocketAsyncEventArgs)
• SendPacketsElements

SendPacketsElement(FileStream, Int64, Int32, Boolean)

來源:

SendPacketsElement.cs

使用指定的 FileStream 物件範圍，初始化 SendPacketsElement 類別的新執行個體，可選擇是否要將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。

public:
 SendPacketsElement(System::IO::FileStream ^ fileStream, long offset, int count, bool endOfPacket);

public SendPacketsElement (System.IO.FileStream fileStream, long offset, int count, bool endOfPacket);

new System.Net.Sockets.SendPacketsElement : System.IO.FileStream * int64 * int * bool -> System.Net.Sockets.SendPacketsElement

Public Sub New (fileStream As FileStream, offset As Long, count As Integer, endOfPacket As Boolean)

參數

fileStream

FileStream

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸的檔案。

offset

Int64

位移 (以位元組為單位)，從檔案開頭到檔案中開始傳送檔案中位元組的位置。

count

Int32

從 offset 參數開始，要傳送的位元組數。 如果 count 為零，就會傳送整個檔案。

endOfPacket

Boolean

指定不應該將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。 這個旗標可用來更精細地控制資料包上或訊息導向通訊端上每個訊息的內容。

例外狀況

ArgumentException

fileStream 參數必須已開啟供非同步讀取和寫入。

ArgumentNullException

fileStream 參數不可為 null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

SendPacketsElement(Byte[], Int32, Int32)

來源:

SendPacketsElement.cs

使用指定的緩衝區範圍，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(cli::array <System::Byte> ^ buffer, int offset, int count);

public SendPacketsElement (byte[] buffer, int offset, int count);

new System.Net.Sockets.SendPacketsElement : byte[] * int * int -> System.Net.Sockets.SendPacketsElement

Public Sub New (buffer As Byte(), offset As Integer, count As Integer)

參數

buffer

Byte[]

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳送之資料的位元組陣列。

offset

Int32

位移 (以位元組為單位)，從 buffer 的開頭到 buffer 中的位置 (buffer 參數中指定開始傳送資料的位置)。

count

Int32

從 offset 參數開始，要傳送的位元組數目。 如果 count 為零，就不會傳送任何位元組。

例外狀況

ArgumentNullException

buffer 參數不可以是 Null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

offset和 count 必須小於緩衝區的大小。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

另請參閱

• ArgumentNullException
• ArgumentOutOfRangeException
• SendPacketsAsync(SocketAsyncEventArgs)
• SendPacketsElements

SendPacketsElement(ReadOnlyMemory<Byte>, Boolean)

來源:

SendPacketsElement.cs

使用指定的緩衝區搭配選項，初始化 類別的新實例 SendPacketsElement ，以將這個專案與從套接字層傳送至傳輸的單一傳送要求中的下一個項目結合。

public:
 SendPacketsElement(ReadOnlyMemory<System::Byte> buffer, bool endOfPacket);

public SendPacketsElement (ReadOnlyMemory<byte> buffer, bool endOfPacket);

new System.Net.Sockets.SendPacketsElement : ReadOnlyMemory<byte> * bool -> System.Net.Sockets.SendPacketsElement

Public Sub New (buffer As ReadOnlyMemory(Of Byte), endOfPacket As Boolean)

參數

buffer

ReadOnlyMemory<Byte>

ReadOnlyMemory<T>使用 方法傳送之位元組的 SendPacketsAsync(SocketAsyncEventArgs) 。

endOfPacket

Boolean

指定不應該將此元素和下一個元素合併於通訊端層對傳輸提出的同一個傳送要求中。 這個旗標可用來更精細地控制資料包上或訊息導向通訊端上每個訊息的內容。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

SendPacketsElement(String)

來源:

SendPacketsElement.cs

使用指定的檔案，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(System::String ^ filepath);

public SendPacketsElement (string filepath);

new System.Net.Sockets.SendPacketsElement : string -> System.Net.Sockets.SendPacketsElement

Public Sub New (filepath As String)

參數

filepath

String

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸之檔案的檔名。

例外狀況

ArgumentNullException

filepath 參數不可以是 Null。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

參數支援 filepath 通用命名慣例 (UNC) 路徑。 如果檔案位於目前的工作目錄中，則不需要指定路徑資訊。

另請參閱

• ArgumentNullException
• SendPacketsAsync(SocketAsyncEventArgs)
• SendPacketsElements

SendPacketsElement(ReadOnlyMemory<Byte>)

來源:

SendPacketsElement.cs

使用指定的緩衝區，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(ReadOnlyMemory<System::Byte> buffer);

public SendPacketsElement (ReadOnlyMemory<byte> buffer);

new System.Net.Sockets.SendPacketsElement : ReadOnlyMemory<byte> -> System.Net.Sockets.SendPacketsElement

Public Sub New (buffer As ReadOnlyMemory(Of Byte))

參數

buffer

ReadOnlyMemory<Byte>

ReadOnlyMemory<T>使用 方法傳送之位元組的 SendPacketsAsync(SocketAsyncEventArgs) 。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

SendPacketsElement(FileStream)

來源:

SendPacketsElement.cs

使用指定的 FileStream 物件，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(System::IO::FileStream ^ fileStream);

public SendPacketsElement (System.IO.FileStream fileStream);

new System.Net.Sockets.SendPacketsElement : System.IO.FileStream -> System.Net.Sockets.SendPacketsElement

Public Sub New (fileStream As FileStream)

參數

fileStream

FileStream

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸的檔案。

例外狀況

ArgumentException

fileStream 未開啟供非同步讀取和寫入。

ArgumentNullException

fileStream 不可以是 null。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。

SendPacketsElement(FileStream, Int64, Int32)

來源:

SendPacketsElement.cs

使用指定的 FileStream 物件範圍，初始化 SendPacketsElement 類別的新執行個體。

public:
 SendPacketsElement(System::IO::FileStream ^ fileStream, long offset, int count);

public SendPacketsElement (System.IO.FileStream fileStream, long offset, int count);

new System.Net.Sockets.SendPacketsElement : System.IO.FileStream * int64 * int -> System.Net.Sockets.SendPacketsElement

Public Sub New (fileStream As FileStream, offset As Long, count As Integer)

參數

fileStream

FileStream

要使用 SendPacketsAsync(SocketAsyncEventArgs) 方法傳輸的檔案。

offset

Int64

位移 (以位元組為單位)，從檔案開頭到檔案中開始傳送檔案中位元組的位置。

count

Int32

從 offset 開始，要傳送的位元組數。 如果 count 為零，就會傳送整個檔案。

例外狀況

ArgumentException

fileStream 參數必須已開啟供非同步讀取和寫入。

ArgumentNullException

fileStream 參數不可為 null。

ArgumentOutOfRangeException

offset 和 count 參數必須大於或等於零。

備註

類別 SendPacketsElement 會與 屬性搭配 SocketAsyncEventArgs.SendPacketsElements 使用，以取得或設定使用 Socket.SendPacketsAsync 方法傳送的數據緩衝區或檔案。