Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Cette classe représente un fichier d’archive Z (compression). Utilisez-la pour composer ou extraire des archives Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryHéritage
Implémente
IArchive, IDisposable, IArchiveFileEntry
Membres hérités
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarques
Voir https://docs.fileformat.com/compression/z/
Constructeurs
ZArchive()
Initialise une nouvelle instance de la classe Aspose.Zip.Z.ZArchive préparée pour la compression.
public ZArchive()ZArchive(Stream, ZArchiveLoadOptions)
Initialise une nouvelle instance de la classe Aspose.Zip.Z.ZArchive préparée pour la décompression.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Paramètres
source Stream
La source de l’archive.
loadOptions ZArchiveLoadOptions
Les options pour charger l’archive.
Remarques
Ce constructeur ne décompresse pas. Voir la méthode Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) pour la décompression.
Exceptions
source n’est pas consultable.
source est nul.
ZArchive(string, ZArchiveLoadOptions)
Initialise une nouvelle instance de la classe Aspose.Zip.Z.ZArchive préparée pour la décompression.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Paramètres
path string
Chemin vers la source de l’archive.
loadOptions ZArchiveLoadOptions
Les options pour charger l’archive.
Remarques
Ce constructeur ne décompresse pas. Voir la méthode Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) pour la décompression.
Exceptions
path est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path est vide, ne contient que des espaces ou contient des caractères invalides.
L’accès au fichier path est refusé.
Le path, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes basées sur Windows, les chemins doivent comporter moins de 248 caractères, et les noms de fichiers doivent comporter moins de 260 caractères.
Le fichier à path contient un deux-points (:) au milieu de la chaîne.
Le fichier est introuvable.
Le chemin spécifié est invalide, comme étant sur un lecteur non mappé.
Le fichier est déjà ouvert.
Méthodes
Dispose()
Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
public void Dispose()Dispose(bool)
Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
protected virtual void Dispose(bool disposing)Paramètres
disposing bool
Indique si les ressources gérées doivent être libérées.
Extract(Stream)
Extrait l’archive Z vers un flux.
public void Extract(Stream destination)Paramètres
destination Stream
Flux pour stocker les données décompressées.
Exemples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}Exceptions
Les données ne peuvent pas être décompressées.
Extract(FileInfo)
Extrait l’archive Z vers un fichier.
public void Extract(FileInfo fileInfo)Paramètres
fileInfo FileInfo
FileInfo pour stocker les données décompressées.
Exemples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Exceptions
L’appelant n’a pas la permission requise pour ouvrir le fileInfo.
Le chemin du fichier est vide ou ne contient que des espaces.
Le fichier est introuvable.
Le chemin vers le fichier est en lecture seule ou est un répertoire.
fileInfo est nul.
Le chemin spécifié est invalide, comme étant sur un lecteur non mappé.
Le fichier est déjà ouvert.
Les données ne peuvent pas être décompressées.
Extract(string)
Extrait l’archive Z vers un fichier par chemin.
public FileInfo Extract(string path)Paramètres
path string
Chemin vers le fichier qui stockera les données décompressées.
Retourne
Info du fichier extrait.
Exemples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}Exceptions
path est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path est vide, ne contient que des espaces ou contient des caractères invalides.
L’accès au fichier path est refusé.
Le path, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes basées sur Windows, les chemins doivent comporter moins de 248 caractères, et les noms de fichiers doivent comporter moins de 260 caractères.
Le fichier à path contient un deux-points (:) au milieu de la chaîne.
Les données ne peuvent pas être décompressées.
ExtractToDirectory(string)
Extrait le contenu de l’archive vers le répertoire fourni.
public void ExtractToDirectory(string destinationDirectory)Paramètres
destinationDirectory string
Le chemin vers le répertoire où placer les fichiers extraits.
Remarques
Si le répertoire n’existe pas, il sera créé.
Exceptions
destinationDirectory est nul.
Le chemin spécifié, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes basées sur Windows, les chemins doivent comporter moins de 248 caractères et les noms de fichiers doivent comporter moins de 260 caractères.
L’appelant n’a pas la permission requise pour accéder au répertoire existant.
Si le répertoire n’existe pas, le chemin contient un caractère deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (“C:").
destinationDirectory est une chaîne de longueur zéro, ne contient que des espaces, ou contient un ou plusieurs caractères invalides. Vous pouvez interroger les caractères invalides en utilisant la méthode System.IO.Path.GetInvalidPathChars.
-ou- le chemin est préfixé par, ou contient, seulement un caractère deux-points (:).
Le répertoire spécifié par le chemin est un fichier. -ou- Le nom du réseau n’est pas connu.
Save(Stream, ZArchiveSaveOptions)
Sauvegarde l’archive xz vers le flux fourni.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Paramètres
output Stream
Flux de destination.
settings ZArchiveSaveOptions
Options facultatives pour la composition de l’archive.
Exemples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Remarques
output doit être consultable.
Exceptions
output ne prend pas en charge la recherche.
output est nul.
Save(string, ZArchiveSaveOptions)
Sauvegarde l’archive Z vers le fichier de destination fourni.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Paramètres
destinationFileName string
+Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.
settings ZArchiveSaveOptions
Options facultatives pour la composition de l’archive.
Exemples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
destinationFileName est nul.
L’appelant n’a pas la permission requise pour accéder.
Le destinationFileName est vide, ne contient que des espaces, ou contient des caractères invalides.
L’accès au fichier destinationFileName est refusé.
Le destinationFileName, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes basées sur Windows, les chemins doivent comporter moins de 248 caractères, et les noms de fichiers doivent comporter moins de 260 caractères.
Le fichier à destinationFileName contient un deux-points (:) au milieu de la chaîne.
SetSource(Stream)
Définit le contenu à compresser dans l’archive.
public void SetSource(Stream source)Paramètres
source Stream
Le flux d’entrée pour l’archive.
Exemples
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}SetSource(FileInfo)
Définit le contenu à compresser dans l’archive.
public void SetSource(FileInfo fileInfo)Paramètres
fileInfo FileInfo
FileInfo qui sera ouvert comme flux d’entrée.
Exemples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
L’appelant n’a pas la permission requise pour ouvrir le fileInfo.
Le chemin du fichier est vide ou ne contient que des espaces.
Le fichier est introuvable.
Le chemin vers le fichier est en lecture seule ou est un répertoire.
fileInfo est nul.
Le chemin spécifié est invalide, comme étant sur un lecteur non mappé.
Le fichier est déjà ouvert.
SetSource(string)
Définit le contenu à compresser dans l’archive.
public void SetSource(string sourcePath)Paramètres
sourcePath string
Chemin vers le fichier qui sera ouvert comme flux d’entrée.
Exemples
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Exceptions
sourcePath est nul ou une chaîne vide.
L’appelant n’a pas la permission requise pour accéder à une ressource.
Le sourcePath est vide, ne contient que des espaces, ou contient des caractères invalides.
L’accès au fichier sourcePath est refusé.
Le sourcePath, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes basées sur Windows, les chemins doivent comporter moins de 248 caractères, et les noms de fichiers doivent comporter moins de 260 caractères.
Le fichier à sourcePath contient un deux-points (:) au milieu de la chaîne.
