次の方法で共有


MemoryStream.WriteAsync メソッド

定義

オーバーロード

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

source に含まれるバイト シーケンスを現在のメモリ ストリームに非同期で書き込み、書き込まれたバイト数だけ、このメモリ ストリーム内の現在の位置を進め、キャンセル要求を監視します。

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

現在のストリームにバイト シーケンスを非同期に書き込み、書き込んだバイト数だけストリーム内の現在位置を進め、キャンセル要求を監視します。

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

ソース:
MemoryStream.cs
ソース:
MemoryStream.cs
ソース:
MemoryStream.cs

source に含まれるバイト シーケンスを現在のメモリ ストリームに非同期で書き込み、書き込まれたバイト数だけ、このメモリ ストリーム内の現在の位置を進め、キャンセル要求を監視します。

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> source, System.Threading.CancellationToken cancellationToken = default);
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
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Overrides Function WriteAsync (source As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask
Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

パラメーター

sourcebuffer
ReadOnlyMemory<Byte>

データを書き込む元のメモリの領域。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

非同期の書き込み操作を表すタスク。

例外

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

適用対象

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

ソース:
MemoryStream.cs
ソース:
MemoryStream.cs
ソース:
MemoryStream.cs

現在のストリームにバイト シーケンスを非同期に書き込み、書き込んだバイト数だけストリーム内の現在位置を進め、キャンセル要求を監視します。

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);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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[]

データの書き込み元となるバッファー。

offset
Int32

ストリームへのバイトのコピーを開始する位置を示す buffer 内のバイト オフセット。インデックス番号は 0 から始まります。

count
Int32

書き込む最大バイト数。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

非同期の書き込み操作を表すタスク。

属性

例外

buffernullです。

offset または count が負の値です。

offsetcount の合計が、バッファーの長さよりも大きいです。

ストリームは書き込みをサポートしません。

ストリームは破棄されています。

ストリームは、前の書き込み操作によって現在使用されています。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

操作が完了する前に取り消された場合、返されるタスクには プロパティの値がCanceledStatus含まれます。

キャンセル トークンを作成するには、 クラスの CancellationTokenSource インスタンスを作成し、 プロパティを Token パラメーターとして cancellationToken 渡します。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Write(Byte[], Int32, Int32)スローされる例外に関するページを参照してください。

適用対象