Class ZstandardArchive

path est nul.

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

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

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

Le path 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 Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.

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

Méthodes

Dispose()

Effectue des tâches définies par l’application associées à la libération, au relâchement 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, au relâchement 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 dans le flux fourni.

public void Extract(Stream destination)

Paramètres

destination Stream

Flux de destination. Doit être écrivable.

Exemples

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

destination ne prend pas en charge l’écriture.

Extract(string)

Extrait l’archive dans le fichier par chemin.

public FileInfo Extract(string path)

Paramètres

path string

Le chemin vers le fichier de destination. Si le fichier existe déjà, il sera écrasé.

Renvoie

FileInfo

Infos du fichier extrait.

Exceptions

path est nul.

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

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

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

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

ExtractToDirectory(string)

Extrait le contenu de l’archive dans 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 Windows, les chemins doivent être inférieurs à 248 caractères et les noms de fichiers doivent être inférieurs à 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 nulle, ne contient que des espaces blancs, 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, uniquement 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.

Open()

Ouvre l’archive pour extraction et fournit un flux avec le contenu de l’archive.

public Stream Open()

Renvoie

Stream

Le flux qui représente le contenu de l’archive.

Exemples

Extrait l'archive et copie le contenu extrait dans un flux de fichier.

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Vous pouvez utiliser la méthode Stream.CopyTo pour .NET 4.0 et supérieur : `unpacked.CopyTo(extracted);`

Remarques

Lisez à partir du flux pour obtenir le contenu original du fichier. Voir la section des exemples.

Save(Stream, ZstandardSaveOptions)

Sauvegarde l’archive dans le flux fourni.

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

Paramètres

outputStream Stream

Flux de destination.

settings ZstandardSaveOptions

Paramètres optionnels pour la composition de l’archive.

Exemples

Écrit des données compressées dans le flux de réponse http.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Remarques

outputStream doit être écrivable.

Exceptions

InvalidOperationException

outputStream n’est pas écrivable.

La source n’a pas été fournie.

Save(string, ZstandardSaveOptions)

Sauvegarde l’archive dans le fichier de destination fourni.

public void Save(string destinationFileName, ZstandardSaveOptions 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 ZstandardSaveOptions

Paramètres optionnels pour la composition de l’archive.

Exemples

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

Exceptions

destinationFileName est nul.

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

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

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

Le destinationFileName 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 Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.

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

Save(FileInfo, ZstandardSaveOptions)

Sauvegarde l’archive dans le fichier de destination fourni.

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

Paramètres

destination FileInfo

FileInfo qui sera ouvert comme flux de destination.

settings ZstandardSaveOptions

Paramètres optionnels pour la composition de l’archive.

Exemples

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.zst"));
}

Exceptions

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

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

FileNotFoundException

Le fichier est introuvable.

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

DirectoryNotFoundException

destination est nul.

Le chemin spécifié est invalide, par exemple en étant sur un lecteur non mappé.

IOException

Le fichier est déjà ouvert.

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 ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

SetSource(FileInfo)

Définit le contenu à compresser dans l’archive.

public void SetSource(FileInfo fileInfo)

Paramètres

fileInfo FileInfo

La référence à un fichier à compresser.

Exemples

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.zst");
}

SetSource(string)

Définit le contenu à compresser dans l’archive.

public void SetSource(string path)

Paramètres

path string

Chemin vers le fichier à compresser.

Exemples

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

Exceptions

path est nul.

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

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

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