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
Implémente
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
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
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 non valides.
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 Windows, les chemins doivent avoir moins de 248 caractères, et les noms de fichiers doivent avoir 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, par exemple, s’il se trouve sur un lecteur non mappé.
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>
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
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
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
sourceDirectory
est nul.
L’appelant n’a pas la permission requise pour accéder à sourceDirectory
.
sourceDirectory
contient des caractères non valides tels que “, <, > ou |.
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
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
name
est trop long pour tar selon la norme IEEE 1003.1-1998.
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
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
name
est trop long pour tar selon la norme IEEE 1003.1-1998.
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
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
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 non valides. - ou - Le nom de fichier, en tant que partie de name
, dépasse 100 symboles.
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 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.
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
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 > 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
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
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
path 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 avoir moins de 248 caractères et les noms de fichiers doivent avoir 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:").
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 (:).
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
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
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
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
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
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
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
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
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
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
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
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
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
Une instance de Aspose.Zip.Tar.TarArchive
Exceptions
Le flux Zstandard est corrompu ou non lisible.
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
Une instance de Aspose.Zip.Tar.TarArchive
Exceptions
Le flux Zstandard est corrompu ou non lisible.
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
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
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.
destinationFileName
est nul.
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.
Le destinationFileName
spécifié est invalide, (par exemple, il se trouve sur un lecteur non mappé).
Une erreur d’E/S est survenue lors de l’ouverture du fichier.
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.
destinationFileName
est dans un format invalide.
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
output
est nul.
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.
Exceptions
output
est nul.
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
output
est nul.
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
output
est nul.
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
output
est nul.
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
output
est nul.
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");
}
}