TarWriter.WriteEntryAsync 메서드

정의

네임스페이스:

System.Formats.Tar

어셈블리:

System.Formats.Tar.dll

오버로드

WriteEntryAsync(TarEntry, CancellationToken)	지정된 항목을 보관 스트림에 비동기적으로 씁니다.
WriteEntryAsync(String, String, CancellationToken)	지정된 파일을 보관 스트림에 tar 항목으로 비동기적으로 씁니다.

WriteEntryAsync(TarEntry, CancellationToken)

Source:

TarWriter.cs

지정된 항목을 보관 스트림에 비동기적으로 씁니다.

public System.Threading.Tasks.Task WriteEntryAsync (System.Formats.Tar.TarEntry entry, System.Threading.CancellationToken cancellationToken = default);

member this.WriteEntryAsync : System.Formats.Tar.TarEntry * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

entry

TarEntry

쓸 tar 항목입니다.

cancellationToken

CancellationToken

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

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ArgumentException

항목 유형이 HardLink 또는 SymbolicLink 이고 가 LinkNamenull 이거나 비어 있습니다.

ObjectDisposedException

보관 스트림이 삭제됩니다.

ArgumentNullException

entry은 null입니다.

IOException

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

OperationCanceledException

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

설명

보관 파일에 항목을 쓰기 전에 항목의 DataStream에 데이터를 쓴 경우 원하는 시작 위치로 되 감아야 합니다.

각 형식에서 쓰기에 지원되는 항목 유형은 다음과 같습니다.

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Pax및 Gnu:

  • BlockDevice
  • CharacterDevice
  • Directory
  • Fifo
  • HardLink
  • RegularFile
  • SymbolicLink

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

WriteEntryAsync(String, String, CancellationToken)

Source:

TarWriter.cs

지정된 파일을 보관 스트림에 tar 항목으로 비동기적으로 씁니다.

public System.Threading.Tasks.Task WriteEntryAsync (string fileName, string? entryName, System.Threading.CancellationToken cancellationToken = default);

member this.WriteEntryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

fileName

String

보관 파일에 쓸 파일의 경로입니다.

entryName

String

보관 파일에 표시되어야 하는 파일의 이름입니다. 선택적 상대 경로와 파일 이름을 포함해야 합니다.

cancellationToken

CancellationToken

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

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

ObjectDisposedException

보관 스트림이 삭제됩니다.

ArgumentException

fileName 또는 entryName이 null이거나 비어 있습니다.

IOException

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

OperationCanceledException

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

설명

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