Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Esta clase representa un archivo uuencoded.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
Herencia
Implementa
IArchive, IDisposable, IArchiveFileEntry
Miembros heredados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructores
UueArchive()
Inicializa una nueva instancia de la clase Aspose.Zip.Uue.UueArchive preparada para la codificación.
public UueArchive()
Ejemplos
El siguiente ejemplo muestra cómo uuencode un archivo.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
UueArchive(Stream)
Inicializa una nueva instancia de la clase Aspose.Zip.Uue.UueArchive preparada para la decodificación.
public UueArchive(Stream sourceStream)
Parámetros
sourceStream
Stream
La fuente del archivo comprimido.
Ejemplos
Abre un archivo comprimido desde un flujo y lo extrae a un MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);
Observaciones
Este constructor no decodifica. Consulte el método Aspose.Zip.Uue.UueArchive.Open para descomprimir.
UueArchive(string)
Inicializa una nueva instancia de la clase Aspose.Zip.Uue.UueArchive.
public UueArchive(string path)
Parámetros
path
string
La ruta al archivo comprimido.
Ejemplos
Abre un archivo comprimido desde la ruta y lo decodifica a un MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);
Observaciones
Este constructor no descomprime. Consulte el método Aspose.Zip.Uue.UueArchive.Open para descomprimir.
Excepciones
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
El path
está vacío, contiene solo espacios en blanco, o contiene caracteres no válidos.
El acceso al archivo path
está denegado.
La path
, el nombre de archivo, o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres, y los nombres de archivo deben ser menores de 260 caracteres.
El archivo en path
contiene dos puntos (:) en medio de la cadena.
Propiedades
Name
Nombre del archivo original.
public string Name { get; }
Valor de la propiedad
Métodos
Dispose()
Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no administrados.
public void Dispose()
Dispose(bool)
Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no administrados.
protected virtual void Dispose(bool disposing)
Parámetros
disposing
bool
Si los recursos administrados deben ser liberados.
Extract(Stream)
Extrae el archivo comprimido al flujo proporcionado.
public void Extract(Stream destination)
Parámetros
destination
Stream
Flujo de destino. Debe ser escribible.
Ejemplos
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}
Excepciones
destination
no admite escritura.
Extract(string)
Extrae el archivo comprimido al archivo por la ruta.
public FileInfo Extract(string path)
Parámetros
path
string
La ruta al archivo de destino. Si el archivo ya existe, será sobrescrito.
Retorna
Información del archivo extraído.
Excepciones
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
El path
está vacío, contiene solo espacios en blanco, o contiene caracteres no válidos.
El acceso al archivo path
está denegado.
La path
, el nombre de archivo, o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres, y los nombres de archivo deben ser menores de 260 caracteres.
El archivo en path
contiene un colon (:) en medio de la cadena.
El archivo no fue encontrado.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
ExtractToDirectory(string)
Extrae el contenido del archivo comprimido al directorio proporcionado.
public void ExtractToDirectory(string destinationDirectory)
Parámetros
destinationDirectory
string
La ruta al directorio donde se colocarán los archivos extraídos.
Observaciones
Si el directorio no existe, será creado.
Excepciones
destinationDirectory
es nulo.
La ruta especificada, el nombre de archivo, o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres y los nombres de archivo deben ser menores de 260 caracteres.
El llamador no tiene el permiso requerido para acceder al directorio existente.
Si el directorio no existe, la ruta contiene un carácter de dos puntos (:) que no es parte de una etiqueta de unidad (“C:").
destinationDirectory
es una cadena de longitud cero, contiene solo espacios en blanco, o contiene uno o más caracteres no válidos. Puede consultar los caracteres no válidos utilizando el método System.IO.Path.GetInvalidPathChars.
-o- la ruta está precedida por, o contiene, solo un carácter de dos puntos (:).
El directorio especificado por la ruta es un archivo. -o- El nombre de la red no es conocido.
Open()
Abre el archivo comprimido para decodificación y proporciona un flujo con el contenido del archivo comprimido.
public Stream Open()
Retorna
El flujo que representa el contenido del archivo comprimido.
Ejemplos
Uso:
Stream decompressed = archive.Open();
.NET 4.0 y superior - usa el método Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 y anterior - copia bytes manualmente:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Observaciones
Lee desde el flujo para obtener el contenido original del archivo. Consulte la sección de ejemplos.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Guarda el archivo comprimido en el flujo proporcionado.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)
Parámetros
outputStream
Stream
Flujo de destino.
saveOptions
UueSaveOptions
Opciones para guardar el archivo comprimido.
Ejemplos
Escribe datos comprimidos en el flujo de respuesta http.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Observaciones
outputStream
debe ser escribible.
Excepciones
No se ha proporcionado la fuente de datos a archivar.
outputStream
no es escribible.
La fuente de archivo es de solo lectura o es un directorio.
La ruta de la fuente de archivo especificada no es válida, como estar en una unidad no asignada.
La fuente de archivo ya está abierta.
Save(string, UueSaveOptions)
Guarda el archivo comprimido en el archivo de destino proporcionado.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)
Parámetros
destinationFileName
string
La ruta del archivo comprimido que se va a crear. Si el nombre de archivo especificado apunta a un archivo existente, será sobrescrito.
saveOptions
UueSaveOptions
Opciones para guardar el archivo comprimido.
Ejemplos
Escribe datos codificados en un archivo.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}
Excepciones
destinationFileName
es nulo.
El llamador no tiene el permiso requerido para acceder.
El destinationFileName
está vacío, contiene solo espacios en blanco, o contiene caracteres no válidos.
El acceso al archivo destinationFileName
está denegado.
La destinationFileName
, el nombre de archivo, o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres, y los nombres de archivo deben ser menores de 260 caracteres.
El archivo en destinationFileName
contiene un colon (:) en medio de la cadena.
SetSource(Stream)
Establece el contenido que se va a codificar dentro del archivo comprimido.
public void SetSource(Stream source)
Parámetros
source
Stream
El flujo de entrada para el archivo comprimido.
Ejemplos
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}
SetSource(FileInfo)
Establece el contenido que se va a comprimir dentro del archivo comprimido.
public void SetSource(FileInfo fileInfo)
Parámetros
fileInfo
FileInfo
La referencia a un archivo que se va a comprimir.
Ejemplos
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}
SetSource(string)
Establece el contenido que se va a codificar dentro del archivo comprimido.
public void SetSource(string path)
Parámetros
path
string
Ruta al archivo que se va a codificar.
Ejemplos
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
Excepciones
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
El path
está vacío, contiene solo espacios en blanco, o contiene caracteres no válidos.
El acceso al archivo path
está denegado.
La path
, el nombre de archivo, o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres, y los nombres de archivo deben ser menores de 260 caracteres.
El archivo en path
contiene un colon (:) en medio de la cadena.