Class SharArchive
Nombre del espacio: Aspose.Zip.Shar Asamblea: Aspose.Zip.dll (25.5.0)
Esta clase representa un archivo agudo.
public class SharArchive : IDisposableInheritance
Implements
Miembros heredados
object.GetType() ,y, object.MemberwiseClone() ,y, object.ToString() ,y, object.Equals(object?) ,y, object.Equals(object?, object?) ,y, object.ReferenceEquals(object?, object?) ,y, object.GetHashCode()
Constructors
SharArchive()
Inicia una nueva instancia de la clase Aspose.Zip.Shar.SharArchive.
public SharArchive()Examples
El siguiente ejemplo muestra cómo comprimir un archivo.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(El string)
Inicia una nueva instancia de la clase Aspose.Zip.Shar.SharArchive preparada para la decompresión.
public SharArchive(string path)Parameters
path string
El camino hacia la fuente del archivo.
Exceptions
path’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.
Se denega el acceso al archivo path.
La ruta path", nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres.
El archivo en path’ contiene una columna (:) en el medio de la línea.
El archivo no se encuentra.
La ruta especificada es invalida, como estar en un disco no mapeado.
El archivo ya está abierto.
Properties
Entries
Obtiene entradas del tipo Aspose.Zip.Shar.SharEntry que constituye el archivo.
public ReadOnlyCollection<sharentry> Entries { get; }Valor de la propiedad
ReadOnlyCollection &ylt; SharEntry >
Methods
CreateEntries(Cortesía, Bool)
Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Directorios para compresión.
includeRootDirectory bool
Indica si incluir el directorio de raíz mismo o no.
Returns
La instancia de entrada de Shar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(sharFile);
}
}Exceptions
sourceDirectory’ is null.
El llamador no tiene el permiso necesario para acceder a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
El camino especificado, el nombre de archivo, o ambos excede la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Siguiente Entrada siguiente: Bool)
Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Directorios para compresión.
includeRootDirectory bool
Indica si incluir el directorio de raíz mismo o no.
Returns
La instancia de entrada de Shar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(sharFile);
}
}Exceptions
directory’ is null.
El llamador no tiene el permiso necesario para acceder a la directory'.
directory’ stands for a file, not for a directory.
CreateEntry(Archivo de la etiqueta: FileInfo, Bool)
Crea una entrada única dentro del archivo.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
El nombre de la entrada.
fileInfo FileInfo
Los metadatos del archivo o de la carpeta para ser comprimido.
openImmediately bool
Es cierto, si se abre el archivo de inmediato, de lo contrario se abre el archivo en el archivo de almacenamiento.
Returns
La instancia de entrada de Shar.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(Síntomas, Síntomas y Bool)
Crea una entrada única dentro del archivo.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
El nombre de la entrada.
sourcePath string
El camino para que el archivo sea comprimido.
openImmediately bool
Es cierto, si se abre el archivo de inmediato, de lo contrario se abre el archivo en el archivo de almacenamiento.
Returns
La instancia de entrada de Shar.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
El nombre de entrada se establece únicamente dentro del parámetro.El nombre de archivo proporcionado en el parámetro no afecta al nombre de entrada.
Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.
Exceptions
sourcePath’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El sourcePath’ es vacío, contiene sólo espacios blancos, o contiene caracteres invalidos. - o - Nombre de archivo, como parte del name’, supera los 100 símbolos.
El acceso al archivo sourcePath’ se denega.
La sourcePath’, nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres. - o - name’ es demasiado largo para agudo.
El archivo en sourcePath’ contiene una columna (:) en el medio de la línea.
CreateEntry(El Stream, el Stream)
Crea una entrada única dentro del archivo.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
El nombre de la entrada.
source Stream
El flujo de entrada para la entrada.
Returns
La instancia de entrada de Shar.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.shar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
DeleteEntry(SharEntry)
Elimina la primera aparición de una entrada específica de la lista de entrada.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
La entrada a eliminar de la lista de entradas.
Returns
La instancia de entrada de Shar.
Examples
Aquí está cómo puedes eliminar todas las entradas excepto la última:
using (var archive = new SharArchive("archive.shar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputSharFile);
}Exceptions
entry’ is null.
DeleteEntry(Int)
Elimina la entrada de la lista de entrada por índice.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
El índice basado en cero de la entrada a eliminar.
Returns
El archivo con la entrada fue eliminado.
Examples
using (var archive = new SharArchive("two_files.shar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.shar");
}Exceptions
entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.
Dispose(BOOL)
Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Los recursos gestionados deben ser eliminados.
Dispose()
Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.
public void Dispose()Save(El string)
Salva archivo a un archivo de destino proporcionado.
public void Save(string destinationFileName)Parameters
destinationFileName string
Si el nombre de archivo especificado indica a un archivo existente, se reescribir.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Es posible guardar un archivo en el mismo camino que fue cargado de. sin embargo, esto no se recomienda porque este enfoque utiliza la copia a un archivo temporal.
Exceptions
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
La destinationFileName’, nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres.
La destinationFileName” especificada es invalida (por ejemplo, se encuentra en un disco no mapeado).
Un error I/O ocurrió al abrir el archivo.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
El archivo no se encuentra.
Save(Stream)
Salva archivos a la corriente proporcionada.
public void Save(Stream output)Parameters
output Stream
El flujo de destino.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Debe ser escrito.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
