TarReader.GetNextEntryAsync(Boolean, CancellationToken) 메서드

정의

네임스페이스:

System.Formats.Tar

어셈블리:

System.Formats.Tar.dll

Source:

TarReader.cs

보관 스트림에서 다음 항목을 비동기적으로 검색합니다.

public System.Threading.Tasks.ValueTask<System.Formats.Tar.TarEntry?> GetNextEntryAsync (bool copyData = false, System.Threading.CancellationToken cancellationToken = default);

member this.GetNextEntryAsync : bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Formats.Tar.TarEntry>

Public Function GetNextEntryAsync (Optional copyData As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TarEntry)

매개 변수

copyData

Boolean

true 항목의 데이터를 새 MemoryStream에 복사하려면 입니다. 이는 기본 보관 스트림이 검색을 지원하지 않고 나중에 데이터에 액세스해야 하는 경우에 유용합니다.

false 데이터를 새 스트림에 복사하지 않아야 하는 경우 입니다. 기본 스트림이 검색을 지원하지 않는 경우 사용자는 이 메서드를 호출한 직후 를 읽고 처리할 DataStream 책임이 있습니다.

기본값은 false입니다.

cancellationToken

CancellationToken

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

반환

ValueTask<TarEntry>

유효한 항목이 TarEntry 발견되었거나 null 보관의 끝에 도달한 경우 instance 포함하는 값 작업입니다.

예외

InvalidDataException

보관 파일의 형식이 잘못되었습니다.

또는

보관 파일에는 다양한 형식의 항목이 포함되어 있습니다.

또는

현재 Pax 보관 파일에서 둘 이상의 전역 확장 특성 항목이 발견되었습니다.

또는

현재 Pax 보관에서 두 개 이상의 확장 특성 항목이 연속적으로 발견되었습니다.

IOException

I/O 문제가 발생했습니다.

OperationCanceledException

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

설명

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