TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

Crear entrada única dentro del archivo.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
ParámetroEscribeDescripción
nameStringEl nombre de la entrada.
sourceStreamEl flujo de entrada para la entrada.
fileInfoFileSystemInfoLos metadatos del archivo o carpeta a comprimir.

Valor_devuelto

Instancia de entrada de alquitrán.

Excepciones

excepcióncondición
PathTooLongExceptionname es demasiado largo para tar según el estándar IEEE 1003.1-1998.
ArgumentExceptionNombre de archivo, como parte dename, supera los 100 símbolos.

Observaciones

El nombre de la entrada se establece únicamente dentroname parámetro. El nombre del archivo proporcionado enfileInfo El parámetro no afecta el nombre de la entrada.

fileInfo puede referirse aDirectoryInfo si la entrada es directorio.

Ejemplos

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

Ver también


CreateEntry(string, FileInfo, bool)

Crear entrada única dentro del archivo.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParámetroEscribeDescripción
nameStringEl nombre de la entrada.
fileInfoFileInfoLos metadatos del archivo o carpeta a comprimir.
openImmediatelyBooleanVerdadero si abre el archivo inmediatamente; de lo contrario, abra el archivo al guardar el archivo.

Valor_devuelto

Instancia de entrada de alquitrán.

Excepciones

excepcióncondición
PathTooLongExceptionname es demasiado largo para tar según el estándar IEEE 1003.1-1998.
ArgumentExceptionNombre de archivo, como parte dename, supera los 100 símbolos.

Observaciones

El nombre de la entrada se establece únicamente dentroname parámetro. El nombre del archivo proporcionado enfileInfo El parámetro no afecta el nombre de la entrada.

fileInfo puede referirse aDirectoryInfo si la entrada es directorio.

Si el archivo se abre inmediatamente conopenImmediatelyparámetro se bloquea hasta que se elimine el archivo.

Ejemplos

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

Ver también


CreateEntry(string, string, bool)

Crear entrada única dentro del archivo.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
ParámetroEscribeDescripción
nameStringEl nombre de la entrada.
pathStringRuta al archivo a comprimir.
openImmediatelyBooleanVerdadero si abre el archivo inmediatamente; de lo contrario, abra el archivo al guardar el archivo.

Valor_devuelto

Instancia de entrada de alquitrán.

Excepciones

excepcióncondición
ArgumentNullExceptionpath es nulo.
SecurityExceptionLa persona que llama no tiene el permiso necesario para acceder.
ArgumentExceptionElpath está vacío, solo contiene espacios en blanco o contiene caracteres no válidos. - o - Nombre de archivo, como parte dename, supera los 100 símbolos.
UnauthorizedAccessExceptionAcceso al archivopath es denegado.
PathTooLongExceptionEl especificadopath , nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres. - o -name es demasiado largo para tar según el estándar IEEE 1003.1-1998.
NotSupportedExceptionArchivo enpath contiene dos puntos (:) en medio de la cadena.

Observaciones

El nombre de la entrada se establece únicamente dentroname parámetro. El nombre del archivo proporcionado enpath El parámetro no afecta el nombre de la entrada.

Si el archivo se abre inmediatamente conopenImmediatelyparámetro se bloquea hasta que se elimine el archivo.

Ejemplos

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

Ver también