TarReader.GetNextEntryAsync(Boolean, CancellationToken) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
보관 스트림에서 다음 항목을 비동기적으로 검색합니다.
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입니다.
반품
유효한 항목이 발견되었거나 null 보관의 끝에 도달한 경우 인스턴스를 포함하는 TarEntry 값 작업입니다.
예외
보관 파일의 형식이 잘못되었습니다.
-또는-
보관 파일에는 다양한 형식의 항목이 포함되어 있습니다.
-또는-
현재 Pax 보관 파일에서 전역 확장 특성 항목이 두 개 이상 발견되었습니다.
-또는-
현재 Pax 보관 파일에서 두 개 이상의 확장 특성 항목이 연속적으로 발견되었습니다.
-또는-
.NET 11 이상 버전만: 항목의 체크섬이 잘못되었습니다.
I/O 문제가 발생했습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 GetNextEntry(Boolean)throw된 예외를 참조하세요.
