Class ZArchive

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, IArchiveFileEntry

Héritage

objectZArchive

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

ArgumentException

source n’est pas consultable.

ArgumentNullException

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

ArgumentNullException

path est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le path est vide, ne contient que des espaces ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier path est refusé.

PathTooLongException

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.

NotSupportedException

Le fichier à path contient un deux-points (:) au milieu de la chaîne.

FileNotFoundException

Le fichier est introuvable.

DirectoryNotFoundException

Le chemin spécifié est invalide, comme étant sur un lecteur non mappé.

IOException

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

InvalidDataException

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

SecurityException

L’appelant n’a pas la permission requise pour ouvrir le fileInfo.

ArgumentException

Le chemin du fichier est vide ou ne contient que des espaces.

FileNotFoundException

Le fichier est introuvable.

UnauthorizedAccessException

Le chemin vers le fichier est en lecture seule ou est un répertoire.

ArgumentNullException

fileInfo est nul.

DirectoryNotFoundException

Le chemin spécifié est invalide, comme étant sur un lecteur non mappé.

IOException

Le fichier est déjà ouvert.

InvalidDataException

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

FileInfo

Info du fichier extrait.

Exemples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Exceptions

ArgumentNullException

path est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le path est vide, ne contient que des espaces ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier path est refusé.

PathTooLongException

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.

NotSupportedException

Le fichier à path contient un deux-points (:) au milieu de la chaîne.

InvalidDataException

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

ArgumentNullException

destinationDirectory est nul.

PathTooLongException

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.

SecurityException

L’appelant n’a pas la permission requise pour accéder au répertoire existant.

NotSupportedException

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:").

ArgumentException

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 (:).

IOException

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

ArgumentException

output ne prend pas en charge la recherche.

ArgumentNullException

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

ArgumentNullException

destinationFileName est nul.

SecurityException

L’appelant n’a pas la permission requise pour accéder.

ArgumentException

Le destinationFileName est vide, ne contient que des espaces, ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier destinationFileName est refusé.

PathTooLongException

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.

NotSupportedException

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

SecurityException

L’appelant n’a pas la permission requise pour ouvrir le fileInfo.

ArgumentException

Le chemin du fichier est vide ou ne contient que des espaces.

FileNotFoundException

Le fichier est introuvable.

UnauthorizedAccessException

Le chemin vers le fichier est en lecture seule ou est un répertoire.

ArgumentNullException

fileInfo est nul.

DirectoryNotFoundException

Le chemin spécifié est invalide, comme étant sur un lecteur non mappé.

IOException

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

ArgumentNullException

sourcePath est nul ou une chaîne vide.

SecurityException

L’appelant n’a pas la permission requise pour accéder à une ressource.

ArgumentException

Le sourcePath est vide, ne contient que des espaces, ou contient des caractères invalides.

UnauthorizedAccessException

L’accès au fichier sourcePath est refusé.

PathTooLongException

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.

NotSupportedException

Le fichier à sourcePath contient un deux-points (:) au milieu de la chaîne.

 Français