다음을 통해 공유


MemoryStream.WriteAsync 메서드

정의

오버로드

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

source에 포함된 바이트의 시퀀스를 현재의 메모리 스트림에 비동기적으로 쓰고, 이 메모리 스트림 내에서 기록한 바이트 수만큼 현재 위치를 앞으로 이동한 후, 취소 요청을 모니터링합니다.

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

바이트의 시퀀스를 현재 스트림에 비동기적으로 쓰고 쓰여진 바이트 수만큼 이 스트림 내의 현재 위치를 앞으로 이동한 후 취소 요청을 모니터링합니다.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
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)

Source:
MemoryStream.cs
Source:
MemoryStream.cs
Source:
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 instance 만들고 속성을 매개 변수로 전달하여 취소 토큰을 TokencancellationToken 만들 수 있습니다.

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

적용 대상