Zum Hauptinhalt springen
Version: 25.125.1350.1

abstract ZipFile

Enthält eine Funktionssammlung für ZIP-Aktionen

Methoden

CreateFromDirectory()

static CreateFromDirectory(
directoryPath,
targetZipFilePath,
compressionLevel?,
includeBaseDirectory?): Promise<void>

Erstellt eine ZIP-Datei aus dem übergebenen Verzeichnis.

Parameter

ParameterTypeDescription
directoryPathstringQuellverzeichnis
targetZipFilePathstringDateipfad der ZIP-Datei
compressionLevel?ZipCompressionLevelOptional (Standardwert: Optimal ): Komprimierungsstufe
includeBaseDirectory?booleanOptional (Standardwert: false ): Gibt an, ob das Quellverzeichnis als Basispfad der ZIP-Datei übernommen werden soll, oder ob lediglich die Inhalte des Ordners herangezogen werden.

Rückgabewert

Promise<void>

Throws

ArgumentException - directoryPath oder targetZipFilePath sind null oder haben die Länge 0

Throws

ArgumentNullException - directoryPath oder targetZipFilePath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von directoryPath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - directoryPath oder targetZipFilePath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Deprecated

Die Funktion steht in zukünftigen Versionen eventuell nicht mehr zur Verfügung und sollte nicht mehr verwendet werden, da diese durch die Funktion createFromDirectoryAsync ersetzt wurde.

Definiert in

cosmolink.SDK.FileSystem.ts:2787


CreateOrAddFromFile()

static CreateOrAddFromFile(
filePath,
targetZipFilePath,
compressionLevel?): Promise<void>

Erstellt eine ZIP-Datei für die übergebe Datei oder fügt die übergebene Datei einer bestehenden ZIP-Datei hinzu

Parameter

ParameterTypeDescription
filePathstringPfad zur Datei welche hinzugefügt werden soll
targetZipFilePathstringDateipfad der ZIP-Datei
compressionLevel?ZipCompressionLevelOptional (Standardwert: Optimal ): Komprimierungsstufe

Rückgabewert

Promise<void>

Throws

ArgumentException - filePath oder targetZipFilePath sind null oder haben die Länge 0

Throws

ArgumentNullException - filePath oder targetZipFilePath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von filePath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - filePath oder targetZipFilePath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von targetZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Deprecated

Die Funktion steht in zukünftigen Versionen eventuell nicht mehr zur Verfügung und sollte nicht mehr verwendet werden, da diese durch die Funktion createOrAddFromFileAsync ersetzt wurde.

Definiert in

cosmolink.SDK.FileSystem.ts:2948


ExtractToDirectory()

static ExtractToDirectory(
sourceZipFilePath,
destDirectoryPath,
overwriteFiles?): Promise<void>

Entpackt die angegebene ZIP-Datei in ein Verzeichnis.

Parameter

ParameterTypeDescription
sourceZipFilePathstringDateipfad der ZIP-Datei
destDirectoryPathstringZielverzeichnis
overwriteFiles?booleanOptional (Standardwert: true ): Gibt an, ob Dateien im Zielverzeichnis überschrieben werden sollen, sofern diese bereits existieren.

Rückgabewert

Promise<void>

Throws

ArgumentException - sourceZipFilePath oder destDirectoryPath sind null oder haben die Länge 0

Throws

ArgumentNullException - sourceZipFilePath oder destDirectoryPath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von destDirectoryPath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - sourceZipFilePath oder destDirectoryPath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von sourceZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Deprecated

Die Funktion steht in zukünftigen Versionen eventuell nicht mehr zur Verfügung und sollte nicht mehr verwendet werden, da diese durch die Funktion extractToDirectoryAsync ersetzt wurde.

Definiert in

cosmolink.SDK.FileSystem.ts:2873


ListEntries()

static ListEntries(targetZipFilePath): Promise<ZipArchiveEntry[]>

Gibt eine Liste aller Elemente innerhalb der ZIP-Datei aus

Parameter

ParameterTypeDescription
targetZipFilePathstringDateipfad der ZIP-Datei

Rückgabewert

Promise<ZipArchiveEntry[]>

Throws

ArgumentException - targetZipFilePath ist null oder hat die Länge 0

Throws

ArgumentNullException - targetZipFilePath ist null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von targetZipFilePath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - targetZipFilePath enthält ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von targetZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Deprecated

Die Funktion steht in zukünftigen Versionen eventuell nicht mehr zur Verfügung und sollte nicht mehr verwendet werden, da diese durch die Funktion listEntriesAsync ersetzt wurde.

Definiert in

cosmolink.SDK.FileSystem.ts:3029


TryExtractToFile()

static TryExtractToFile(
sourceZipFilePath,
entryFullName,
destFilePath,
overwrite): Promise<boolean>

Entpackt das angegebene Element aus einer ZIP-Datei

Parameter

ParameterTypeDescription
sourceZipFilePathstringDateipfad der ZIP-Datei
entryFullNamestringVollständiger Name des zu entpackenden Elements
destFilePathstringZielpfad für die Datei
overwritebooleanOptional (Standardwert: true ): Gibt an, ob die Datei überschrieben werden soll, sofern diese bereits existieren.

Rückgabewert

Promise<boolean>

Throws

ArgumentException - sourceZipFilePath oder destFilePath sind null oder haben die Länge 0

Throws

ArgumentNullException - sourceZipFilePath oder destFilePath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von destFilePath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - sourceZipFilePath oder destFilePath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von sourceZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Deprecated

Die Funktion steht in zukünftigen Versionen eventuell nicht mehr zur Verfügung und sollte nicht mehr verwendet werden, da diese durch die Funktion tryExtractToFileAsync ersetzt wurde.

Definiert in

cosmolink.SDK.FileSystem.ts:3107


createFromDirectoryAsync()

static createFromDirectoryAsync(
directoryPath,
targetZipFilePath,
compressionLevel?,
includeBaseDirectory?): Promise<void>

Erstellt eine ZIP-Datei aus dem übergebenen Verzeichnis.

Parameter

ParameterTypeDescription
directoryPathstringQuellverzeichnis
targetZipFilePathstringDateipfad der ZIP-Datei
compressionLevel?ZipCompressionLevelOptional (Standardwert: Optimal ): Komprimierungsstufe
includeBaseDirectory?booleanOptional (Standardwert: false ): Gibt an, ob das Quellverzeichnis als Basispfad der ZIP-Datei übernommen werden soll, oder ob lediglich die Inhalte des Ordners herangezogen werden.

Rückgabewert

Promise<void>

Throws

ArgumentException - directoryPath oder targetZipFilePath sind null oder haben die Länge 0

Throws

ArgumentNullException - directoryPath oder targetZipFilePath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von directoryPath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - directoryPath oder targetZipFilePath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Definiert in

cosmolink.SDK.FileSystem.ts:2828


createOrAddFromFileAsync()

static createOrAddFromFileAsync(
filePath,
targetZipFilePath,
compressionLevel?): Promise<void>

Erstellt eine ZIP-Datei für die übergebe Datei oder fügt die übergebene Datei einer bestehenden ZIP-Datei hinzu

Parameter

ParameterTypeDescription
filePathstringPfad zur Datei welche hinzugefügt werden soll
targetZipFilePathstringDateipfad der ZIP-Datei
compressionLevel?ZipCompressionLevelOptional (Standardwert: Optimal ): Komprimierungsstufe

Rückgabewert

Promise<void>

Throws

ArgumentException - filePath oder targetZipFilePath sind null oder haben die Länge 0

Throws

ArgumentNullException - filePath oder targetZipFilePath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von filePath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - filePath oder targetZipFilePath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von targetZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Definiert in

cosmolink.SDK.FileSystem.ts:2989


extractToDirectoryAsync()

static extractToDirectoryAsync(
sourceZipFilePath,
destDirectoryPath,
overwriteFiles?): Promise<void>

Entpackt die angegebene ZIP-Datei in ein Verzeichnis.

Parameter

ParameterTypeDescription
sourceZipFilePathstringDateipfad der ZIP-Datei
destDirectoryPathstringZielverzeichnis
overwriteFiles?booleanOptional (Standardwert: true ): Gibt an, ob Dateien im Zielverzeichnis überschrieben werden sollen, sofern diese bereits existieren.

Rückgabewert

Promise<void>

Throws

ArgumentException - sourceZipFilePath oder destDirectoryPath sind null oder haben die Länge 0

Throws

ArgumentNullException - sourceZipFilePath oder destDirectoryPath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von destDirectoryPath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - sourceZipFilePath oder destDirectoryPath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von sourceZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Definiert in

cosmolink.SDK.FileSystem.ts:2910


listEntriesAsync()

static listEntriesAsync(targetZipFilePath): Promise<ZipArchiveEntry[]>

Gibt eine Liste aller Elemente innerhalb der ZIP-Datei aus

Parameter

ParameterTypeDescription
targetZipFilePathstringDateipfad der ZIP-Datei

Rückgabewert

Promise<ZipArchiveEntry[]>

Throws

ArgumentException - targetZipFilePath ist null oder hat die Länge 0

Throws

ArgumentNullException - targetZipFilePath ist null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von targetZipFilePath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - targetZipFilePath enthält ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von targetZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Definiert in

cosmolink.SDK.FileSystem.ts:3066


tryExtractToFileAsync()

static tryExtractToFileAsync(
sourceZipFilePath,
entryFullName,
destFilePath,
overwrite): Promise<boolean>

Entpackt das angegebene Element aus einer ZIP-Datei

Parameter

ParameterTypeDescription
sourceZipFilePathstringDateipfad der ZIP-Datei
entryFullNamestringVollständiger Name des zu entpackenden Elements
destFilePathstringZielpfad für die Datei
overwritebooleanOptional (Standardwert: true ): Gibt an, ob die Datei überschrieben werden soll, sofern diese bereits existieren.

Rückgabewert

Promise<boolean>

Throws

ArgumentException - sourceZipFilePath oder destFilePath sind null oder haben die Länge 0

Throws

ArgumentNullException - sourceZipFilePath oder destFilePath sind null

Throws

PathTooLongException - Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein.

Throws

DirectoryNotFoundException - Der Pfad von destFilePath ist ungültig

Throws

IOException - Das durch path angegebene Verzeichnis ist schreibgeschützt.

Throws

UnauthorizedAccessException - Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Throws

NotSupportedException - sourceZipFilePath oder destFilePath enthalten ein Doppelpunktzeichen (:), das nicht Bestandteil einer Laufwerksbezeichnung ist.

Throws

FileNotFoundException - Der Pfad von sourceZipFilePath ist ungültig

Throws

InvalidDataException - Die ZIP-Datei ist ungültig

Definiert in

cosmolink.SDK.FileSystem.ts:3138