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)

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Source:: 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

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

파일의 위치가 고급이 아닙니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64)된 예외를 참조하세요.

적용 대상

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

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Source:: 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