Class XarArchive
Nome do espaço: Aspose.Zip.Xar Assembleia: Aspose.Zip.dll (25.5.0)
Esta classe representa um arquivo xar.
public class XarArchive : IArchive, IDisposableInheritance
Implements
Membros herdados
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XarArchive(XarCompressionSettings)
Inicia uma nova instância da classe Aspose.Zip.Xar.XarArchive.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parameters
defaultCompressionSettings XarCompressionSettings
As configurações de compressão padrão, aplicadas a todas as entradas do arquivo.
Examples
O exemplo a seguir mostra como comprimir um arquivo.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(Armazém, XarLoadOptions)
Inicia uma nova instância da classe Aspose.Zip.Xar.xarArchive e compõe uma lista de entradas que pode ser extraída do arquivo.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parameters
sourceStream Stream
A fonte do arquivo deve ser procurável.
loadOptions XarLoadOptions
As opções para carregar arquivos com.
Examples
O exemplo a seguir mostra como extrair todas as entradas para um diretório.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Este fabricante não despaque qualquer entrada. ver Aspose.Zip.Xar.XarFileEntry.Open método para despaque.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid xar archive.
XarArchive(Título: XarLoadOptions)
Inicia uma nova instância da classe Aspose.Zip.Xar.xarArchive e compõe uma lista de entradas que pode ser extraída do arquivo.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parameters
path string
O caminho para o arquivo.
loadOptions XarLoadOptions
As opções para carregar arquivos com.
Examples
O exemplo a seguir mostra como extrair todas as entradas para um diretório.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Este fabricante não despaque qualquer entrada. ver Aspose.Zip.Xar.XarFileEntry.Open método para despaque.
Exceptions
path’ is null.
O requerente não tem a permissão necessária para o acesso.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.
O arquivo no path’ contém uma coluna (:) no meio da linha.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo já está aberto.
O arquivo no path’ não é arquivo xar válido.
Properties
Entries
Recebe entradas do tipo Aspose.Zip.Xar.XarEntry que constituem o arquivo.
public IEnumerable<xarentry> Entries { get; }Valor da propriedade
IEnumerable e o PT; XarEntry >
Methods
CreateEntries(Título: Bool, XarCompressionSettings)
Adicione ao arquivo todos os arquivos e diretórios repetidamente no diretório dado.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
sourceDirectory string
Diretório para compressão.
includeRootDirectory bool
Indica se incluir o diretório de raiz ou não.
compressionSettings XarCompressionSettings
As configurações de compressão utilizadas para adicionar itens Aspose.Zip.Xar.XarEntry.
Returns
Introdução à instância.
Examples
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(@"C:\folder", false);
archive.Save(xarFile);
}
}Exceptions
sourceDirectory’ is null.
O chamador não tem a permissão necessária para acessar sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
O caminho especificado, o nome de arquivo, ou ambos, excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DiretórioInfo, bool, XarCompressionSettings)
Adicione ao arquivo todos os arquivos e diretórios repetidamente no diretório dado.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
directory DirectoryInfo
Diretório para compressão.
includeRootDirectory bool
Indica se incluir o diretório de raiz ou não.
compressionSettings XarCompressionSettings
As configurações de compressão utilizadas para adicionar itens Aspose.Zip.Xar.XarEntry.
Returns
Introdução à instância.
Examples
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
archive.Save(xarFile);
}
}Exceptions
directory’ is null.
O chamador não tem a permissão necessária para aceder ao directory”.
directory’ stands for a file, not for a directory.
CreateEntry(Título, FileInfo, Bool, XarCompressionSettings)
Crie uma única entrada dentro do arquivo.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
O nome da entrada.
fileInfo FileInfo
Os metadados do arquivo ou folha para ser comprimido.
openImmediately bool
É verdade, se abrir o arquivo imediatamente, caso contrário, abrir o arquivo em arquivo de armazenamento.
compressionSettings XarCompressionSettings
As configurações de compressão utilizadas para adicionar o item Aspose.Zip.Xar.XarEntry.
Returns
Introdução à instância.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}Remarks
Se o arquivo for aberto imediatamente com o parâmetro, ele será bloqueado até que o arquivo seja apagado.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(string, string, bool, XarCompressionSettings)
Crie uma única entrada dentro do arquivo.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
O nome da entrada.
sourcePath string
O caminho para o arquivo ser comprimido.
openImmediately bool
É verdade, se abrir o arquivo imediatamente, caso contrário, abrir o arquivo em arquivo de armazenamento.
compressionSettings XarCompressionSettings
As configurações de compressão utilizadas para adicionar o item Aspose.Zip.Xar.XarEntry.
Returns
Introdução à instância.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}Remarks
O nome de entrada é definido apenas dentro do parâmetro.O nome de arquivo fornecido no parâmetro não afeta o nome de entrada.
Se o arquivo for aberto imediatamente com o parâmetro, ele será bloqueado até que o arquivo seja apagado.
Exceptions
sourcePath’ is null.
O requerente não tem a permissão necessária para o acesso.
O sourcePath’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos. - ou - Nome do arquivo, como parte do name’, excede 100 símbolos.
O acesso ao arquivo sourcePath’ é negado.
O nome de arquivo especificado sourcePath, ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres. - ou - name’ é demasiado longo para xar.
O arquivo em sourcePath’ contém uma coluna (:) no meio da linha.
Não é possível alterar o arquivo.
CreateEntry(Título: Título, Título, Título)
Crie uma única entrada dentro do arquivo.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parameters
name string
O nome da entrada.
source Stream
O fluxo de entrada para a entrada.
compressionSettings XarCompressionSettings
As configurações de compressão utilizadas para adicionar o item Aspose.Zip.Xar.XarEntry.
Returns
Introdução à instância.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.xar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
Não é possível alterar o arquivo.
DeleteEntry(XarEntry)
Remove a primeira ocorrência de uma entrada específica da lista de entrada.
public XarArchive DeleteEntry(XarEntry entry)Parameters
entry XarEntry
A entrada para remover da lista de entradas.
Returns
Introdução à instância.
Examples
Aqui está como você pode remover todas as entradas exceto a última:
using (var archive = new XarArchive("archive.xar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}Exceptions
entry’ is null.
Dispose()
Exerce tarefas definidas por aplicação associadas à libertação, libertação ou restauração de recursos não gerenciados.
public void Dispose()Dispose(Bolha)
Exerce tarefas definidas por aplicação associadas à libertação, libertação ou restauração de recursos não gerenciados.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Se os recursos gerenciados devem ser dissolvidos.
ExtractToDirectory(Redação)
Extrair todos os arquivos do arquivo para o diretório fornecido.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
O caminho para o diretório para colocar os arquivos extraídos.
Examples
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Se o diretório não existe, será criado.
Exceptions
O caminho é zero
O caminho especificado, o nome do arquivo ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres e os nomes do arquivo devem ser menores de 260 caracteres.
O chamador não tem a permissão necessária para acessar o diretório existente.
Se o diretório não existe, o caminho contém um caráter colon (:) que não faz parte de uma etiqueta de disco (“C:”).
O caminho é uma faixa de comprimento zero, contém apenas espaço branco, ou contém um ou mais caracteres invalidos. Você pode solicitar caracteres invalidos usando o método System.IO.Path.GetInvalidPathChars. -or- caminho é prefixado com, ou contém, apenas um caráter colon (:).
O diretório especificado pelo caminho é um arquivo. -or- O nome da rede não é conhecido.
O arquivo é corrompido.
Save(Título: XarSaveOptions)
Salve arquivo para o arquivo de destino fornecido.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parameters
destinationFileName string
Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobreescrito.
saveOptions XarSaveOptions
Opções para salvar arquivo xar com.
Exceptions
destinationFileName’ is null.
Não é possível alterar o arquivo.
Save(Armazém, XarSaveOptions)
Salve arquivo para o fluxo fornecido.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parameters
output Stream
fluxo de destino.
saveOptions XarSaveOptions
Opções para salvar arquivo xar com.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
Não é possível alterar o arquivo.
