ZipFile.OpenReadAsync(String, CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Öffnet asynchron einen ZipArchive auf dem angegebenen Pfad zum Lesen. Die angegebene Datei wird mit FileMode.Opengeöffnet.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchive> OpenReadAsync(string archiveFileName, System.Threading.CancellationToken cancellationToken = default);static member OpenReadAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchive>Public Shared Function OpenReadAsync (archiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchive)Parameter
- archiveFileName
- String
Eine Zeichenfolge, die den Pfad im Dateisystem angibt, um das Archiv zu öffnen. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ausnahmen
archiveFileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
archiveFileName ist null.
Der angegebene archiveFileName überschreitet die vom System definierte maximale Länge.
Auf Windows-basierten Plattformen müssen Pfade beispielsweise kleiner als 248 Zeichen sein, und Dateinamen müssen kleiner als 260 Zeichen sein.
Der angegebene archiveFileName ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein nicht angegebener E/A-Fehler aufgetreten.
archiveFileName ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Die in "archiveFileName" angegebene Datei wurde nicht gefunden.
archiveFileName weist ein ungültiges Format auf.
Die angegebene Datei konnte nicht als ZIP-Datei interpretiert werden.
Ein asynchroner Vorgang wird abgebrochen.
