TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

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

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ParamètreTaperLa description
nameStringLe nom de l’entrée.
sourceStreamLe flux d’entrée pour l’entrée.
fileInfoFileSystemInfoLes métadonnées du fichier ou du dossier à compresser.

Return_Value

Instance d’entrée tar.

Exceptions

exceptioncondition
PathTooLongExceptionname est trop long pour tar selon la norme IEEE 1003.1-1998.
ArgumentExceptionNom de fichier, dans le cadre dename, dépasse 100 symboles.

Remarques

Le nom de l’entrée est défini uniquement dansname paramètre. Le nom de fichier fourni dansfileInfo Le paramètre n’affecte pas le nom de l’entrée.

fileInfo peut faire référence àDirectoryInfo si l’entrée est répertoire.

Exemples

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

Voir également


CreateEntry(string, FileInfo, bool)

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

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParamètreTaperLa description
nameStringLe nom de l’entrée.
fileInfoFileInfoLes métadonnées du fichier ou du dossier à compresser.
openImmediatelyBooleanVrai si ouvrir le fichier immédiatement, sinon ouvrir le fichier lors de l’enregistrement de l’archive.

Return_Value

Instance d’entrée tar.

Exceptions

exceptioncondition
PathTooLongExceptionname est trop long pour tar selon la norme IEEE 1003.1-1998.
ArgumentExceptionNom de fichier, dans le cadre dename, dépasse 100 symboles.

Remarques

Le nom de l’entrée est défini uniquement dansname paramètre. Le nom de fichier fourni dansfileInfo Le paramètre n’affecte pas le nom de l’entrée.

fileInfo peut faire référence àDirectoryInfo si l’entrée est répertoire.

Si le fichier est ouvert immédiatement avecopenImmediatelyparamètre, il devient bloqué jusqu’à ce que l’archive soit supprimée.

Exemples

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

Voir également


CreateEntry(string, string, bool)

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

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ParamètreTaperLa description
nameStringLe nom de l’entrée.
pathStringChemin d’accès au fichier à compresser.
openImmediatelyBooleanVrai si ouvrir le fichier immédiatement, sinon ouvrir le fichier lors de l’enregistrement de l’archive.

Return_Value

Instance d’entrée tar.

Exceptions

exceptioncondition
ArgumentNullExceptionpath est nul.
SecurityExceptionL’appelant n’a pas l’autorisation requise pour accéder.
ArgumentExceptionLepath est vide, ne contient que des espaces blancs ou contient des caractères non valides. - ou - Nom de fichier, dans le cadre dename, dépasse 100 symboles.
UnauthorizedAccessExceptionAccéder au dossierpath est refusé.
PathTooLongExceptionLe spécifiépath , nom de fichier ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plates-formes Windows, les chemins doivent comporter moins de 248 caractères et les noms de fichiers doivent comporter moins de 260 caractères. - ou -name est trop long pour tar selon la norme IEEE 1003.1-1998.
NotSupportedExceptionFichier àpath contient deux-points (:) au milieu de la chaîne.

Remarques

Le nom de l’entrée est défini uniquement dansname paramètre. Le nom de fichier fourni danspath Le paramètre n’affecte pas le nom de l’entrée.

Si le fichier est ouvert immédiatement avecopenImmediatelyparamètre, il devient bloqué jusqu’à ce que l’archive soit supprimée.

Exemples

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

Voir également