TarWriter.WriteEntryAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| WriteEntryAsync(TarEntry, CancellationToken) |
Skriver asynkront den angivna posten till arkivströmmen. |
| WriteEntryAsync(String, String, CancellationToken) |
Skriver asynkront den angivna filen i arkivströmmen som en tjärpost. |
WriteEntryAsync(TarEntry, CancellationToken)
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
Skriver asynkront den angivna posten till arkivströmmen.
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
Parametrar
- entry
- TarEntry
Tjärposten som ska skrivas.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona skrivåtgärden.
Undantag
Posttypen är HardLink eller SymbolicLink och LinkName är null eller tom.
Arkivströmmen tas bort.
entry är null.
Ett I/O-problem uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Innan du skriver en post i arkivet, om du skrev data till postens DataStream, måste du spola tillbaka den till önskad startposition.
Det här är de posttyper som stöds för att skriva i varje format:
V7:
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av WriteEntry(TarEntry).
Gäller för
WriteEntryAsync(String, String, CancellationToken)
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
- Källa:
- TarWriter.cs
Skriver asynkront den angivna filen i arkivströmmen som en tjärpost.
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
Parametrar
- fileName
- String
Sökvägen till filen som ska skrivas till arkivet.
- entryName
- String
Namnet på filen som den ska representeras i arkivet. Den bör innehålla den valfria relativa sökvägen och filnamnet.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona skrivåtgärden.
Undantag
Arkivströmmen tas bort.
fileName eller entryName är null eller tom.
Ett I/O-problem uppstod.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av WriteEntry(String, String).