TarWriter.WriteEntryAsync Metoda

Definicja

Przestrzeń nazw:

System.Formats.Tar

Zestaw:

System.Formats.Tar.dll

Przeciążenia

WriteEntryAsync(TarEntry, CancellationToken)	Asynchronicznie zapisuje określony wpis w strumieniu archiwum.
WriteEntryAsync(String, String, CancellationToken)	Asynchronicznie zapisuje określony plik w strumieniu archiwum jako wpis tar.

WriteEntryAsync(TarEntry, CancellationToken)

Źródło:

TarWriter.cs

Asynchronicznie zapisuje określony wpis w strumieniu archiwum.

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

Parametry

entry

TarEntry

Wpis tar do zapisu.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

ArgumentException

Typ wpisu to HardLink lub , a LinkName parametr jest lub jest nullSymbolicLink pusty.

ObjectDisposedException

Strumień archiwum jest usuwany.

ArgumentNullException

entry to null.

IOException

Wystąpił problem z we/wy.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Przed zapisaniem wpisu w archiwum, jeśli zapisano dane w wpisie DataStream, pamiętaj, aby przewinąć go do żądanej pozycji początkowej.

Są to typy wpisów obsługiwane do zapisywania w każdym formacie:

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Paxi Gnu:

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

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteEntry(TarEntry)usługę .

WriteEntryAsync(String, String, CancellationToken)

Źródło:

TarWriter.cs

Asynchronicznie zapisuje określony plik w strumieniu archiwum jako wpis 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

Parametry

fileName

String

Ścieżka do pliku do zapisu w archiwum.

entryName

String

Nazwa pliku, który powinien być reprezentowany w archiwum. Powinna zawierać opcjonalną ścieżkę względną i nazwę pliku.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

ObjectDisposedException

Strumień archiwum jest usuwany.

ArgumentException

fileName lub entryName jest lub jest null pusty.

IOException

Wystąpił problem z we/wy.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteEntry(String, String)usługę .