Class UueArchive

Class UueArchive

Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)

Esta classe representa um arquivo uuencoded.

public class UueArchive : IArchive, IDisposable, IArchiveFileEntry

Herança

objectUueArchive

Implementa

IArchive, IDisposable, IArchiveFileEntry

Membros Herdados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Construtores

UueArchive()

Inicializa uma nova instância da classe Aspose.Zip.Uue.UueArchive preparada para codificação.

public UueArchive()

Exemplos

O exemplo a seguir mostra como uuencode um arquivo.

using (var archive = new UueArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.uue");
}

UueArchive(Stream)

Inicializa uma nova instância da classe Aspose.Zip.Uue.UueArchive preparada para decodificação.

public UueArchive(Stream sourceStream)

Parâmetros

sourceStream Stream

A origem do arquivo.

Exemplos

Abra um arquivo a partir de um stream e extraia-o para um MemoryStream

var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
  archive.Open().CopyTo(ms);

Observações

Este construtor não decodifica. Veja o método Aspose.Zip.Uue.UueArchive.Open para descompressão.

UueArchive(string)

Inicializa uma nova instância da classe Aspose.Zip.Uue.UueArchive.

public UueArchive(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Exemplos

Abra um arquivo a partir do caminho e decodifique-o para um MemoryStream

var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
  archive.Open().CopyTo(ms);

Observações

Este construtor não descomprime. Veja o método Aspose.Zip.Uue.UueArchive.Open para descompressão.

Exceções

ArgumentNullException

path é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path é negado.

PathTooLongException

O path, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em path contém dois pontos (:) no meio da string.

Propriedades

Name

Nome do arquivo original.

public string Name { get; }

Valor da Propriedade

string

Métodos

Dispose()

Executa tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

public void Dispose()

Dispose(bool)

Executa tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

protected virtual void Dispose(bool disposing)

Parâmetros

disposing bool

Se os recursos gerenciados devem ser liberados.

Extract(Stream)

Extrai o arquivo para o stream fornecido.

public void Extract(Stream destination)

Parâmetros

destination Stream

Stream de destino. Deve ser gravável.

Exemplos

using (var archive = new UueArchive("archive.uue"))
{
     archive.Extract(httpResponseStream);
}

Exceções

ArgumentException

destination não suporta gravação.

Extract(string)

Extrai o arquivo para o arquivo pelo caminho.

public FileInfo Extract(string path)

Parâmetros

path string

O caminho para o arquivo de destino. Se o arquivo já existir, ele será sobrescrito.

Retorna

FileInfo

Informações do arquivo extraído.

Exceções

ArgumentNullException

path é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O path está vazio, contém apenas espaços em branco, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path é negado.

PathTooLongException

O path, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em path contém dois pontos (:) no meio da string.

FileNotFoundException

O arquivo não foi encontrado.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

ExtractToDirectory(string)

Extrai o conteúdo do arquivo para o diretório fornecido.

public void ExtractToDirectory(string destinationDirectory)

Parâmetros

destinationDirectory string

O caminho para o diretório onde os arquivos extraídos serão colocados.

Observações

Se o diretório não existir, ele será criado.

Exceções

ArgumentNullException

destinationDirectory é nulo.

PathTooLongException

O caminho especificado, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

SecurityException

O chamador não tem a permissão necessária para acessar o diretório existente.

NotSupportedException

Se o diretório não existir, o caminho contém um caractere de dois pontos (:) que não faz parte de um rótulo de unidade (“C:").

ArgumentException

destinationDirectory é uma string de comprimento zero, contém apenas espaços em branco, ou contém um ou mais caracteres inválidos. Você pode consultar caracteres inválidos usando o método System.IO.Path.GetInvalidPathChars. -ou- o caminho é prefixado com, ou contém, apenas um caractere de dois pontos (:).

IOException

O diretório especificado pelo caminho é um arquivo. -ou- O nome da rede não é conhecido.

Open()

Abre o arquivo para decodificação e fornece um stream com o conteúdo do arquivo.

public Stream Open()

Retorna

Stream

O stream que representa o conteúdo do arquivo.

Exemplos

Uso: Stream decompressed = archive.Open();

.NET 4.0 e superior - use o método Stream.CopyTo: decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 e anteriores - copie bytes manualmente:

byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
 fileStream.Write(buffer, 0, bytesRead);
```</p>

#### Observações

Leia do stream para obter o conteúdo original do arquivo. Veja a seção de exemplos.

### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)

Salva o arquivo no stream fornecido.

```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)

Parâmetros

outputStream Stream

Stream de destino.

saveOptions UueSaveOptions

Opções para a salvaguarda do arquivo.

Exemplos

Escreve dados compactados no stream de resposta http.

using (var archive = new UueArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Observações

outputStream deve ser gravável.

Exceções

InvalidOperationException

A origem dos dados a serem arquivados não foi fornecida.

ArgumentException

outputStream não é gravável.

UnauthorizedAccessException

A origem do arquivo é somente leitura ou é um diretório.

DirectoryNotFoundException

O caminho da origem do arquivo especificado é inválido, como estar em uma unidade não mapeada.

IOException

A origem do arquivo já está aberta.

Save(string, UueSaveOptions)

Salva o arquivo no arquivo de destino fornecido.

public void Save(string destinationFileName, UueSaveOptions saveOptions = null)

Parâmetros

destinationFileName string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado apontar para um arquivo existente, ele será sobrescrito.

saveOptions UueSaveOptions

Opções para a salvaguarda do arquivo.

Exemplos

Escreve dados codificados em um arquivo.

using (var archive = new UueArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.uue");
}

Exceções

ArgumentNullException

destinationFileName é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O destinationFileName está vazio, contém apenas espaços em branco, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo destinationFileName é negado.

PathTooLongException

O destinationFileName, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em destinationFileName contém dois pontos (:) no meio da string.

SetSource(Stream)

Define o conteúdo a ser codificado dentro do arquivo.

public void SetSource(Stream source)

Parâmetros

source Stream

O stream de entrada para o arquivo.

Exemplos

using (var archive = new UueArchive()) 
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.uue");
}

SetSource(FileInfo)

Define o conteúdo a ser compactado dentro do arquivo.

public void SetSource(FileInfo fileInfo)

Parâmetros

fileInfo FileInfo

A referência a um arquivo a ser compactado.

Exemplos

using (var archive = new UueArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.uue");
}

SetSource(string)

Define o conteúdo a ser codificado dentro do arquivo.

public void SetSource(string path)

Parâmetros

path string

Caminho para o arquivo a ser codificado.

Exemplos

using (var archive = new UueArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.uue");
}

Exceções

ArgumentNullException

path é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O path está vazio, contém apenas espaços em branco, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path é negado.

PathTooLongException

O path, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em path contém dois pontos (:) no meio da string.

 Português