Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Cette classe représente un fichier d’archive tar. Utilisez-la pour composer, extraire ou mettre à jour des archives tar.

public class TarArchive : IArchive, IDisposable

Héritage

objectTarArchive

Implémente

IArchive, IDisposable

Membres hérités

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructeurs

TarArchive()

Initialise une nouvelle instance de la classe Aspose.Zip.Tar.TarArchive.

public TarArchive()

Exemples

L'exemple suivant montre comment compresser un fichier.

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.tar");
}

TarArchive(Stream)

Initialise une nouvelle instance de la classe Aspose.Zip.Archive et compose une liste d’entrées pouvant être extraites de l’archive.

public TarArchive(Stream sourceStream)

Paramètres

sourceStream Stream

La source de l’archive. Elle doit être accessible en recherche.

Exemples

L'exemple suivant montre comment extraire toutes les entrées dans un répertoire.

using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarques

Ce constructeur ne décompresse aucune entrée. Voir la méthode Aspose.Zip.Tar.TarEntry.Open pour la décompression.

Exceptions

InvalidDataException

sourceStream n’est pas accessible en recherche.

TarArchive(string)

Initialise une nouvelle instance de la classe Aspose.Zip.Tar.TarArchive et compose une liste d’entrées pouvant être extraites de l’archive.

public TarArchive(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Exemples

L'exemple suivant montre comment extraire toutes les entrées dans un répertoire.

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarques

Ce constructeur ne décompresse aucune entrée. Voir la méthode Aspose.Zip.Tar.TarEntry.Open 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 non valides.

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 Windows, les chemins doivent avoir moins de 248 caractères, et les noms de fichiers doivent avoir 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, par exemple, s’il se trouve sur un lecteur non mappé.

IOException

Le fichier est déjà ouvert.

Propriétés

Entries

Obtient les entrées de type Aspose.Zip.Tar.TarEntry constituant l’archive.

public ReadOnlyCollection<tarentry> Entries { get; }

Valeur de la propriété

ReadOnlyCollection<TarEntry&gt;

Méthodes

CreateEntries(DirectoryInfo, bool)

Ajoute à l’archive tous les fichiers et répertoires de manière récursive dans le répertoire donné.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

Paramètres

directory DirectoryInfo

Répertoire à compresser.

includeRootDirectory bool

Indique s’il faut inclure le répertoire racine lui-même ou non.

Retourne

TarArchive

L’archive avec les entrées composées.

Exemples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(tarFile);
    }
}

CreateEntries(string, bool)

Ajoute à l’archive tous les fichiers et répertoires de manière récursive dans le répertoire donné.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Paramètres

sourceDirectory string

Répertoire à compresser.

includeRootDirectory bool

Indique s’il faut inclure le répertoire racine lui-même ou non.

Retourne

TarArchive

L’archive avec les entrées composées.

Exemples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

Exceptions

ArgumentNullException

sourceDirectory est nul.

SecurityException

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

ArgumentException

sourceDirectory contient des caractères non valides tels que “, <, > ou |.

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 Windows, les chemins doivent avoir moins de 248 caractères, et les noms de fichiers doivent avoir moins de 260 caractères. Le chemin spécifié, le nom de fichier, ou les deux sont trop longs.

CreateEntry(string, Stream, FileSystemInfo)

Créer une seule entrée dans l’archive.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Paramètres

name string

Le nom de l’entrée.

source Stream

Le flux d’entrée pour l’entrée.

fileInfo FileSystemInfo

Les métadonnées du fichier ou du dossier à compresser.

Retourne

TarEntry

Instance d’entrée Tar.

Exemples

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Remarques

Le nom de l'entrée est uniquement défini dans le paramètre name. Le nom de fichier fourni dans le paramètre fileInfo n'affecte pas le nom de l'entrée.

fileInfo peut faire référence à System.IO.DirectoryInfo si l'entrée est un répertoire.

Exceptions

PathTooLongException

name est trop long pour tar selon la norme IEEE 1003.1-1998.

ArgumentException

Le nom de fichier, en tant que partie de name, dépasse 100 symboles.

CreateEntry(string, FileInfo, bool)

Créer une seule entrée dans l’archive.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

Paramètres

name string

Le nom de l’entrée.

fileInfo FileInfo

Les métadonnées du fichier ou du dossier à compresser.

openImmediately bool

Vrai si le fichier est ouvert immédiatement, sinon le fichier est ouvert lors de l’enregistrement de l’archive.

Retourne

TarEntry

Instance d’entrée Tar.

Exemples

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Remarques

Le nom de l'entrée est uniquement défini dans le paramètre name. Le nom de fichier fourni dans le paramètre fileInfo n'affecte pas le nom de l'entrée.

fileInfo peut faire référence à System.IO.DirectoryInfo si l'entrée est un répertoire.

Si le fichier est ouvert immédiatement avec le paramètre openImmediately, il devient bloqué jusqu'à ce que l'archive soit disposée.

Exceptions

PathTooLongException

name est trop long pour tar selon la norme IEEE 1003.1-1998.

ArgumentException

Le nom de fichier, en tant que partie de name, dépasse 100 symboles.

CreateEntry(string, string, bool)

Créer une seule entrée dans l’archive.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Paramètres

name string

Le nom de l’entrée.

path string

Chemin vers le fichier à compresser.

openImmediately bool

Vrai si le fichier est ouvert immédiatement, sinon le fichier est ouvert lors de l’enregistrement de l’archive.

Retourne

TarEntry

Instance d’entrée Tar.

Exemples

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save(outputTarFile);
}

Remarques

Le nom de l'entrée est uniquement défini dans le paramètre name. Le nom de fichier fourni dans le paramètre path n'affecte pas le nom de l'entrée.

Si le fichier est ouvert immédiatement avec le paramètre openImmediately, il devient bloqué jusqu'à ce que l'archive soit disposée.

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 non valides. - ou - Le nom de fichier, en tant que partie de name, dépasse 100 symboles.

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 Windows, les chemins doivent avoir moins de 248 caractères, et les noms de fichiers doivent avoir moins de 260 caractères. - ou - name est trop long pour tar selon la norme IEEE 1003.1-1998.

NotSupportedException

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

DeleteEntry(TarEntry)

Supprime la première occurrence d’une entrée spécifique de la liste des entrées.

public TarArchive DeleteEntry(TarEntry entry)

Paramètres

entry TarEntry

L’entrée à supprimer de la liste des entrées.

Retourne

TarArchive

L’archive avec l’entrée supprimée.

Exemples

Voici comment vous pouvez supprimer toutes les entrées sauf la dernière :

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

Supprime l’entrée de la liste des entrées par index.

public TarArchive DeleteEntry(int entryIndex)

Paramètres

entryIndex int

L’index basé sur zéro de l’entrée à supprimer.

Retourne

TarArchive

L’archive avec l’entrée supprimée.

Exemples

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

Exceptions

ArgumentOutOfRangeException

entryIndex est inférieur à 0. - ou - entryIndex est égal ou supérieur au nombre d’Entries.

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.

ExtractToDirectory(string)

Extrait tous les fichiers 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.

Exemples

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarques

Si le répertoire n’existe pas, il sera créé.

Exceptions

ArgumentNullException

path 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 Windows, les chemins doivent avoir moins de 248 caractères et les noms de fichiers doivent avoir 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

Le chemin est une chaîne de longueur zéro, ne contient que des espaces ou contient un ou plusieurs caractères non valides. Vous pouvez interroger les caractères non valides 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.

FromGZip(Stream)

Extrait l’archive gzip fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive gzip est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromGZip(Stream source)

Paramètres

source Stream

La source de l’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

Le flux d’extraction GZip n’est pas accessible en recherche de par la nature de l’algorithme de compression. L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

Exceptions

InvalidDataException

L’archive est corrompue.

FromGZip(string)

Extrait l’archive gzip fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive gzip est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromGZip(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

Le flux d’extraction GZip n’est pas accessible en recherche de par la nature de l’algorithme de compression. L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

Exceptions

InvalidDataException

L’archive est corrompue.

FromLZMA(Stream)

Extrait l’archive LZMA fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive LZMA est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromLZMA(Stream source)

Paramètres

source Stream

La source de l’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

Le flux d’extraction LZMA n’est pas accessible en recherche de par la nature de l’algorithme de compression. L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromLZMA(string)

Extrait l’archive LZMA fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive LZMA est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromLZMA(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

Le flux d’extraction LZMA n’est pas accessible en recherche de par la nature de l’algorithme de compression. L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromLZip(Stream)

Extrait l’archive lzip fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive lzip est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromLZip(Stream source)

Paramètres

source Stream

La source de l’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

Le flux d’extraction lzip n’est pas accessible en recherche de par la nature de l’algorithme de compression. L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromLZip(string)

Extrait l’archive lzip fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive lzip est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromLZip(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

Le flux d’extraction lzip n’est pas accessible en recherche de par la nature de l’algorithme de compression. L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromXz(Stream)

Extrait l’archive au format xz fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive xz est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromXz(Stream source)

Paramètres

source Stream

La source de l’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromXz(string)

Extrait l’archive au format xz fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive xz est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromXz(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromZ(Stream)

Extrait l’archive au format Z fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive Z est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromZ(Stream source)

Paramètres

source Stream

La source de l’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromZ(string)

Extrait l’archive au format Z fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive Z est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromZ(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Remarques

L’archive Tar fournit la possibilité d’extraire un enregistrement arbitraire, elle doit donc fonctionner avec un flux accessible en recherche sous le capot.

FromZstandard(Stream)

Extrait l’archive au format Zstandard fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive Zstandard est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromZstandard(Stream source)

Paramètres

source Stream

La source de l’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Le flux Zstandard est corrompu ou non lisible.

InvalidDataException

Les données sont corrompues.

FromZstandard(string)

Extrait l’archive au format Zstandard fournie et compose Aspose.Zip.Tar.TarArchive à partir des données extraites.

Important : l'archive Zstandard est entièrement extraite dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

public static TarArchive FromZstandard(string path)

Paramètres

path string

Le chemin vers le fichier d’archive.

Retourne

TarArchive

Une instance de Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Le flux Zstandard est corrompu ou non lisible.

InvalidDataException

Les données sont corrompues.

Save(Stream, TarFormat?)

Sauvegarde l’archive dans le flux fourni.

public void Save(Stream output, TarFormat? format = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Remarques

output doit être écrivable.

Exceptions

ArgumentException

output n’est pas écrivable. - ou - output est le même flux que celui dont nous extrayons. - OU - Il est impossible de sauvegarder l’archive dans le format en raison de restrictions de format.

Save(string, TarFormat?)

Sauvegarde l’archive dans le fichier de destination fourni.

public void Save(string destinationFileName, TarFormat? format = 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é.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Remarques

Il est possible de sauvegarder une archive au même chemin d'où elle a été chargée. Cependant, cela n'est pas recommandé car cette approche utilise une copie dans un fichier temporaire.

Exceptions

ArgumentException

destinationFileName est une chaîne de longueur zéro, ne contient que des espaces, ou contient un ou plusieurs caractères non valides tels que définis par System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName est nul.

PathTooLongException

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 avoir moins de 248 caractères, et les noms de fichiers doivent avoir moins de 260 caractères.

DirectoryNotFoundException

Le destinationFileName spécifié est invalide, (par exemple, il se trouve sur un lecteur non mappé).

IOException

Une erreur d’E/S est survenue lors de l’ouverture du fichier.

UnauthorizedAccessException

destinationFileName spécifie un fichier qui est en lecture seule et l’accès n’est pas en lecture. - ou - le chemin spécifie un répertoire. - ou - L’appelant n’a pas la permission requise.

NotSupportedException

destinationFileName est dans un format invalide.

FileNotFoundException

Le fichier est introuvable.

SaveGzipped(Stream, TarFormat?)

Sauvegarde l’archive dans le flux avec compression gzip.

public void SaveGzipped(Stream output, TarFormat? format = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

Remarques

output doit être écrivable.

Exceptions

ArgumentNullException

output est nul.

ArgumentException

output n’est pas écrivable.

SaveGzipped(string, TarFormat?)

Sauvegarde l’archive dans le fichier par chemin avec compression gzip.

public void SaveGzipped(string path, TarFormat? format = null)

Paramètres

path string

Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

Sauvegarde l’archive dans le flux avec compression LZMA.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

Remarques

output doit être écrivable.

Important : l'archive tar est composée puis compressée dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

Exceptions

ArgumentNullException

output est nul.

ArgumentException

output n’est pas écrivable.

SaveLZMACompressed(string, TarFormat?)

Sauvegarde l’archive dans le fichier par chemin avec compression lzma.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Paramètres

path string

Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

Remarques

Important : l’archive tar est composée puis compressée dans cette méthode, son contenu est conservé en interne. Attention à la consommation de mémoire.

SaveLzipped(Stream, TarFormat?)

Sauvegarde l’archive dans le flux avec compression lzip.

public void SaveLzipped(Stream output, TarFormat? format = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

Remarques

output doit être écrivable.

Exceptions

ArgumentNullException

output est nul.

ArgumentException

output n’est pas écrivable.

SaveLzipped(string, TarFormat?)

Sauvegarde l’archive dans le fichier par chemin avec compression lzip.

public void SaveLzipped(string path, TarFormat? format = null)

Paramètres

path string

Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Sauvegarde l’archive dans le flux avec compression xz.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

settings XzArchiveSettings

Ensemble de paramètres particuliers à l’archive xz : taille du dictionnaire, taille du bloc, type de vérification.

Exemples

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

Remarques

output Le flux doit être écrivable.

Exceptions

ArgumentNullException

output est nul.

ArgumentException

output n’est pas écrivable.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Sauvegarde l’archive au chemin par chemin avec compression xz.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Paramètres

path string

Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

settings XzArchiveSettings

Ensemble de paramètres particuliers à l’archive xz : taille du dictionnaire, taille du bloc, type de vérification.

Exemples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

Sauvegarde l’archive dans le flux avec compression Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

Remarques

output doit être écrivable.

Exceptions

ArgumentNullException

output est nul.

ArgumentException

output n’est pas écrivable.

SaveZCompressed(string, TarFormat?)

Sauvegarde l’archive au chemin par chemin avec compression Z.

public void SaveZCompressed(string path, TarFormat? format = null)

Paramètres

path string

Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

SaveZstandard(Stream, TarFormat?)

Sauvegarde l’archive dans le flux avec compression Zstandard.

public void SaveZstandard(Stream output, TarFormat? format = null)

Paramètres

output Stream

Flux de destination.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

Remarques

output doit être écrivable.

Exceptions

ArgumentNullException

output est nul.

ArgumentException

output n’est pas écrivable.

SaveZstandard(string, TarFormat?)

Sauvegarde l’archive dans le fichier par chemin avec compression Zstandard.

public void SaveZstandard(string path, TarFormat? format = null)

Paramètres

path string

Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.

format TarFormat?

Définit le format d’en-tête tar. Une valeur nulle sera traitée comme USTar lorsque cela est possible.

Exemples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}
 Français