다음을 통해 공유


IsolatedStorageFileStream.ReadAsync 메서드

정의

오버로드

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

현재 버퍼링된 IsolatedStorageFileStream 개체의 바이트를 바이트 배열에 비동기식으로 복사합니다.

ReadAsync(Memory<Byte>, CancellationToken)

현재 버퍼링된 IsolatedStorageFileStream 개체의 바이트를 바이트 메모리 범위에 비동기식으로 복사합니다.

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

Source:
IsolatedStorageFileStream.cs
Source:
IsolatedStorageFileStream.cs
Source:
IsolatedStorageFileStream.cs

현재 버퍼링된 IsolatedStorageFileStream 개체의 바이트를 바이트 배열에 비동기식으로 복사합니다.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

매개 변수

buffer
Byte[]

데이터를 쓸 버퍼입니다.

offset
Int32

쓰기를 시작할 버퍼의 오프셋입니다.

count
Int32

읽을 최대 바이트 수입니다.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반환

비동기 읽기 작업을 나타내는 작업입니다. buffer로 읽어온 총 바이트 수를 래핑합니다. 이 바이트 수는 현재 사용 가능한 바이트가 충분하지 않은 경우 요청된 바이트 수보다 작을 수 있으며 스트림의 끝에 도달하면 0이 됩니다.

예외

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

설명

매개 변수는 클래스의 인스턴스이거나 , , , UInt16UInt64UInt32SByteSingleInt32Int64CharInt16또는 Double형식 Byte중 하나의 배열일 수 있습니다.Bufferbuffer

읽기 작업이 성공하면 스트림의 현재 위치는 읽은 바이트 수만큼 고급화됩니다. 예외가 발생하면 스트림의 현재 위치가 변경되지 않습니다.

메서드는 ReadAsync 실제 형식에 buffer 관계없이 매개 변수를 바이트 블록으로 처리합니다. 마찬가지로 offsetcount 매개 변수는 항상 바이트로 지정됩니다. 바이트 배열 이외의 매개 변수의 경우 buffer 또는 에 대한 올바른 값을 offsetcount형성하려면 요소 인덱스 또는 요소 수를 바이트 단위로 곱해야 합니다.

메서드는 ReadAsync 스트림의 끝에 도달한 경우에만 0을 반환합니다. 다른 모든 경우에서 는 ReadAsync 반환하기 전에 항상 스트림에서 하나 이상의 바이트를 읽습니다. 호출 시 ReadAsync개체에서 IsolatedStorageFileStream 사용할 수 있는 데이터가 없는 경우 메서드는 하나 이상의 데이터 바이트가 반환될 때까지 차단됩니다.

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

적용 대상

ReadAsync(Memory<Byte>, CancellationToken)

Source:
IsolatedStorageFileStream.cs
Source:
IsolatedStorageFileStream.cs
Source:
IsolatedStorageFileStream.cs

현재 버퍼링된 IsolatedStorageFileStream 개체의 바이트를 바이트 메모리 범위에 비동기식으로 복사합니다.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

매개 변수

buffer
Memory<Byte>

데이터를 쓸 버퍼입니다.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반환

비동기 읽기 작업을 나타내는 작업입니다. buffer로 읽어온 총 바이트 수를 래핑합니다. 이 바이트 수는 현재 사용 가능한 바이트가 충분하지 않은 경우 요청된 바이트 수보다 작을 수 있으며 스트림의 끝에 도달하면 0이 됩니다.

예외

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

적용 대상