ZipFileExtensions.CreateEntryFromFileAsync 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.
Fügt dem Archiv unter dem angegebenen Eintragsnamen asynchron eine Datei aus dem Dateisystem hinzu.
Überlädt
| Name | Beschreibung |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Fügt dem Archiv unter dem angegebenen Eintragsnamen asynchron eine Datei aus dem Dateisystem hinzu. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Fügt dem Archiv unter dem angegebenen Eintragsnamen asynchron eine Datei aus dem Dateisystem hinzu. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Fügt dem Archiv unter dem angegebenen Eintragsnamen asynchron eine Datei aus dem Dateisystem hinzu.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parameter
- destination
- ZipArchive
Das ZIP-Archiv, dem die Datei hinzugefügt werden soll.
- sourceFileName
- String
Der Pfad zur Datei im Dateisystem, aus der kopiert werden soll. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- entryName
- String
Der Name des zu erstellenden Eintrags.
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ein Wrapper für den neu erstellten Eintrag.
Ausnahmen
sourceFileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
-oder-
entryName ist eine leere Zeichenfolge.
sourceFileName oder entryName ist null.
In sourceFileName, der angegebene Pfad, der Dateiname oder beide überschreiten 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 sourceFileName Wert ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der durch sourceFileNamedie Datei angegebenen Datei ist ein E/A-Fehler aufgetreten.
sourceFileName ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Die angegebene sourceFileName Datei wurde nicht gefunden.
sourceFileName ist in einem ungültigen Format vorhanden, oder das ZipArchive unterstützt das Schreiben nicht.
Die ZipArchive wurde bereits geschlossen.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Der neue Eintrag im Archiv enthält den Inhalt der Datei.
Die letzte Schreibzeit des Archiveintrags wird auf die letzte Schreibzeit der Datei im Dateisystem festgelegt.
Wenn im Archiv bereits ein Eintrag mit dem angegebenen Namen vorhanden ist, wird ein zweiter Eintrag erstellt, der über einen identischen Namen verfügt.
Wenn die angegebene Quelldatei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste datumstime im Zip-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet. Wenn im Archiv bereits ein Eintrag mit dem angegebenen Namen vorhanden ist, wird ein zweiter Eintrag erstellt, der über einen identischen Namen verfügt. Da kein CompressionLevel Wert angegeben ist, wird der von der Implementierung des zugrunde liegenden Komprimierungsalgorithmus bereitgestellte Standard verwendet; der ZipArchive Standardwert wird nicht festgelegt.
(Derzeit wird der zugrunde liegende Komprimierungsalgorithmus von der DeflateStream Klasse bereitgestellt.)
Gilt für:
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Fügt dem Archiv unter dem angegebenen Eintragsnamen asynchron eine Datei aus dem Dateisystem hinzu.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parameter
- destination
- ZipArchive
Das ZIP-Archiv, dem die Datei hinzugefügt werden soll.
- sourceFileName
- String
Der Pfad zur Datei im Dateisystem, aus der kopiert werden soll. Der Pfad darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- entryName
- String
Der Name des zu erstellenden Eintrags.
- compressionLevel
- CompressionLevel
Die Komprimierungsebene (Geschwindigkeit/Arbeitsspeicher im Vergleich zur komprimierten Größe).
- cancellationToken
- CancellationToken
Das Abbruchtoken, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Ein Wrapper für den neu erstellten Eintrag.
Ausnahmen
sourceFileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie von InvalidPathChars definiert.
-oder-
entryName ist eine leere Zeichenfolge.
sourceFileName oder entryName ist null.
In sourceFileName, der angegebene Pfad, der Dateiname oder beide überschreiten 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 sourceFileName Wert ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der durch sourceFileNamedie Datei angegebenen Datei ist ein E/A-Fehler aufgetreten.
sourceFileName ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Die angegebene sourceFileName Datei wurde nicht gefunden.
sourceFileName ist in einem ungültigen Format vorhanden, oder das ZipArchive unterstützt das Schreiben nicht.
Die ZipArchive wurde bereits geschlossen.
Ein asynchroner Vorgang wird abgebrochen.
Hinweise
Der neue Eintrag im Archiv enthält den Inhalt der Datei.
Die letzte Schreibzeit des Archiveintrags wird auf die letzte Schreibzeit der Datei im Dateisystem festgelegt.
Wenn im Archiv bereits ein Eintrag mit dem angegebenen Namen vorhanden ist, wird ein zweiter Eintrag erstellt, der über einen identischen Namen verfügt.
Wenn die angegebene Quelldatei eine ungültige Uhrzeit der letzten Änderung aufweist, wird das erste datumstime im Zip-Zeitstempelformat (Mitternacht am 1. Januar 1980) verwendet. Wenn im Archiv bereits ein Eintrag mit dem angegebenen Namen vorhanden ist, wird ein zweiter Eintrag erstellt, der über einen identischen Namen verfügt.
