NetworkStream.WriteAsync 方法

定義

命名空間:

System.Net.Sockets

組件:

netstandard.dll, System.Net.Sockets.dll

多載

名稱	Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	將資料從唯讀記憶體位元組記憶體範圍寫入 NetworkStream ，作為非同步操作。
WriteAsync(Byte[], Int32, Int32, CancellationToken)	將指定範圍內的位元組陣列資料寫入非 NetworkStream 同步操作。

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

來源:

NetworkStream.cs

將資料從唯讀記憶體位元組記憶體範圍寫入 NetworkStream ，作為非同步操作。

public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

參數

buffer

ReadOnlyMemory<Byte>

一個包含要寫入 .NetworkStream

cancellationToken

CancellationToken

用來監控取消申請的代幣。

傳回

ValueTask

一個代表非同步寫入操作的任務。

例外狀況

InvalidOperationException

它 NetworkStream 不支援寫作。

IOException

存取該套接字時發生錯誤。

-或-

寫入網路時發生了故障。

ObjectDisposedException

那是 NetworkStream 關門的。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法會將所有位元組 buffer 傳送到網路。

Note

打電話給物業NetworkStream確認CanWrite是否可承保。 如果你嘗試寫入 NetworkStream 一個不可寫的 ，你會得到一個 InvalidOperationException。

Note

如果你收到， IOException請檢查該 InnerException 物業以判斷是否由某個因素 SocketException造成。 若有，請使用 ErrorCode 屬性取得特定錯誤代碼，並參考 Windows Sockets 版本 2 API 錯誤代碼文件以獲得錯誤的詳細描述。

WriteAsync(Byte[], Int32, Int32, CancellationToken)

來源:

NetworkStream.cs

將指定範圍內的位元組陣列資料寫入非 NetworkStream 同步操作。

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

參數

buffer

Byte[]

一個位元組陣列，包含要寫入 NetworkStream的 。

offset

Int32

從 buffer 哪裡開始寫入資料。

count

Int32

寫入 NetworkStream.

cancellationToken

CancellationToken

用來監控取消申請的代幣。

傳回

Task

一個代表非同步寫入操作的任務。

例外狀況

ArgumentNullException

參數 buffer 為 null。

ArgumentOutOfRangeException

參數 offset 小於 0。

-或-

參數 offset 大於 的 buffer長度。

-或-

參數 size 小於 0。

-或-

參數 size 大於長度 buffer 減去參數 offset 值。

InvalidOperationException

它 NetworkStream 不支援寫作。

IOException

寫入網路時發生了故障。

-或-

存取該套接字時發生錯誤。

ObjectDisposedException

那是 NetworkStream 關門的。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法從指定 offset 開始，從 內容中傳送 count 位元組 buffer 到網路。

Note

打電話給物業NetworkStream確認CanWrite是否可承保。 如果你嘗試寫入 NetworkStream 一個不可寫的 ，你會得到一個 InvalidOperationException。

Note

如果你收到， IOException請檢查該 InnerException 物業以判斷是否由某個因素 SocketException造成。 若有，請使用 ErrorCode 屬性取得特定錯誤代碼，並參考 Windows Sockets 版本 2 API 錯誤代碼文件以獲得錯誤的詳細描述。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Write(Byte[], Int32, Int32)拋出的例外。