Zum Hauptinhalt springen
Version: 1.24.299.1526

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.

Definiert in​

SDK/Cosmolink.Scripting.SDK.FileSystem.ts:1530


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

Definiert in​

SDK/Cosmolink.Scripting.SDK.FileSystem.ts:1617


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

Definiert in​

SDK/Cosmolink.Scripting.SDK.FileSystem.ts:1578


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

Definiert in​

SDK/Cosmolink.Scripting.SDK.FileSystem.ts:1659


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

Definiert in​

SDK/Cosmolink.Scripting.SDK.FileSystem.ts:1697