TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

Crea una singola voce all’interno dell’archivio.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ParametroTipoDescrizione
nameStringIl nome della voce.
sourceStreamIl flusso di input per la voce.
fileInfoFileSystemInfoI metadati del file o della cartella da comprimere.

Valore di ritorno

Istanza di ingresso tar.

Eccezioni

eccezionecondizione
PathTooLongExceptionname è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.
ArgumentExceptionNome del file, come parte diname, supera i 100 simboli.

Osservazioni

Il nome della voce è impostato esclusivamente all’internoname parametro. Il nome del file fornito infileInfo parametro non influisce sul nome della voce.

fileInfo può fare riferimento aDirectoryInfo se la voce è directory.

Esempi

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

Guarda anche


CreateEntry(string, FileInfo, bool)

Crea una singola voce all’interno dell’archivio.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParametroTipoDescrizione
nameStringIl nome della voce.
fileInfoFileInfoI metadati del file o della cartella da comprimere.
openImmediatelyBooleanVero se apri il file immediatamente, altrimenti apri il file al salvataggio in archivio.

Valore di ritorno

Istanza di ingresso tar.

Eccezioni

eccezionecondizione
PathTooLongExceptionname è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.
ArgumentExceptionNome del file, come parte diname, supera i 100 simboli.

Osservazioni

Il nome della voce è impostato esclusivamente all’internoname parametro. Il nome del file fornito infileInfo parametro non influisce sul nome della voce.

fileInfo può fare riferimento aDirectoryInfo se la voce è directory.

Se il file viene aperto immediatamente conopenImmediatelyparametro diventa bloccato fino a quando l’archivio non viene eliminato.

Esempi

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

Guarda anche


CreateEntry(string, string, bool)

Crea una singola voce all’interno dell’archivio.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ParametroTipoDescrizione
nameStringIl nome della voce.
pathStringPercorso del file da comprimere.
openImmediatelyBooleanVero se apri il file immediatamente, altrimenti apri il file al salvataggio in archivio.

Valore di ritorno

Istanza di ingresso tar.

Eccezioni

eccezionecondizione
ArgumentNullExceptionpath è zero.
SecurityExceptionIl chiamante non dispone dell’autorizzazione richiesta per l’accesso.
ArgumentExceptionILpath è vuoto, contiene solo spazi bianchi o contiene caratteri non validi. - oppure - Nome file, come parte diname, supera i 100 simboli.
UnauthorizedAccessExceptionAccesso all’archiviopath è negato.
PathTooLongExceptionIl specificatopath , nome file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono contenere meno di 248 caratteri ei nomi file devono contenere meno di 260 caratteri. - O -name è troppo lungo per tar secondo lo standard IEEE 1003.1-1998.
NotSupportedExceptionFile apath contiene i due punti (:) al centro della stringa.

Osservazioni

Il nome della voce è impostato esclusivamente all’internoname parametro. Il nome del file fornito inpath parametro non influisce sul nome della voce.

Se il file viene aperto immediatamente conopenImmediatelyparametro diventa bloccato fino a quando l’archivio non viene eliminato.

Esempi

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

Guarda anche