Zum Hauptinhalt springen
Version: 25.153.1225.1

abstract ZipFile

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2745

Enthält eine Funktionssammlung für ZIP-Aktionen

Methoden

CreateFromDirectory()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2787

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.


createFromDirectoryAsync()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2828

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.


CreateOrAddFromFile()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2948

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.


createOrAddFromFileAsync()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2989

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


ExtractToDirectory()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2873

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.


extractToDirectoryAsync()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:2910

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


ListEntries()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:3029

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.


listEntriesAsync()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:3066

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


TryExtractToFile()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:3107

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.


tryExtractToFileAsync()

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

Definiert in: sdk/cosmolink.SDK.FileSystem.ts:3138

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