RandomAccess.WriteAsync メソッド

定義

名前空間:: System.IO

アセンブリ:: System.Runtime.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)	指定されたバッファーから特定のオフセットの特定のファイルにバイトシーケンスを書き込みます。
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)	指定されたバッファーから特定のオフセットの特定のファイルにバイトシーケンスを書き込みます。

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

指定されたバッファーから特定のオフセットの特定のファイルにバイトシーケンスを書き込みます。

public static System.Threading.Tasks.ValueTask WriteAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

パラメーター

handle: SafeFileHandle

ファイルハンドル。

buffers: IReadOnlyList<ReadOnlyMemory<Byte>>

メモリバッファーの一覧。このメソッドは、これらのバッファーの内容をファイルにコピーします。

fileOffset: Int64

書き込むファイルの位置。

cancellationToken: CancellationToken

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

返品

ValueTask

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

例外

ArgumentNullException

handle または buffers が null。

ArgumentException

handle が無効です。

ObjectDisposedException

ファイルが閉じられます。

NotSupportedException

このファイルはシーク (パイプまたはソケット) をサポートしていません。

ArgumentOutOfRangeException

fileOffset が負の値です。

UnauthorizedAccessException

handle が書き込み用に開かれていました。

IOException

I/O エラーが発生しました。

OperationCanceledException

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

注釈

ファイルの位置が高度ではありません。

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

適用対象

WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

ソース:: RandomAccess.cs

指定されたバッファーから特定のオフセットの特定のファイルにバイトシーケンスを書き込みます。

public static System.Threading.Tasks.ValueTask WriteAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, ReadOnlyMemory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * ReadOnlyMemory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask