Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Стъпка, XarLoadOptions)`

Иницијализира нова инстанция на Aspose.Zip.Xar.xarArchive клас и съставя списък с вход, който може да бъде извлечен от архива.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Пътят към архивите.

loadOptions XarLoadOptions

Опции за изтегляне на архиви.

`Examples`

Следващият пример показва как да се извлекат всички записи в директория.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Aspose.Zip.Xar.XarFileEntry.Open.

`Exceptions`

path’ is null.

Призователят няма изискваното разрешение за достъп.

UnauthorizedAccessException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

code class=“paramref”>path.

DirectoryNotFoundException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

code class=“paramref”>path.

FileNotFoundException

Документът не е намерен.

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

Филмът вече е отворен.

InvalidDataException

code class=“paramref”>path.

`Properties`

`Entries`

Aspose.Zip.Xar.XarEntry.

public IEnumerable<xarentry> Entries { get; }

`стойност на имота`

IEnumerable < XarEntry >

`Methods`

`CreateEntries(Стринг, боол, XarCompressionSettings)`

Добавете към архива всички файлове и директории отново и отново в дадена директория.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

Директор за компресиране.

includeRootDirectory bool

Показва дали да се включи самата коренна директория или не.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Входната инстанция.

`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.

code class=“paramref”>sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

Windows, пътеките трябва да са по-малко от 248 знака, а имената на файловете трябва да са по-малко от 260.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(ДирективаInfo, Bool, XarCompressionSettings)`

Добавете към архива всички файлове и директории отново и отново в дадена директория.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

Директор за компресиране.

includeRootDirectory bool

Показва дали да се включи самата коренна директория или не.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Входната инстанция.

`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.

code class=“paramref”>directory'.

directory’ stands for a file, not for a directory.

`CreateEntry(лента, FileInfo, bool, XarCompressionSettings)`

Създаване на един вход в архива.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Името на входа.

fileInfo FileInfo

метаданните на файла или папката, които трябва да бъдат компресирани.

openImmediately bool

Вярно е, че ако отворите файла веднага, в противен случай отворете файлът на архива.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Входната инстанция.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

`Remarks`

Ако файлът се отваря незабавно с параметър, той се блокира, докато архивите не бъдат изтрити.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string, string, bool, XarCompressionSettings)`

Създаване на един вход в архива.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Името на входа.

sourcePath string

Пътят към файла да бъде компресиран.

openImmediately bool

Вярно е, че ако отворите файла веднага, в противен случай отворете файлът на архива.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Входната инстанция.

`Examples`

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

`Remarks`

Името на файла, предоставено в параметър, не засяга името на входа.

Ако файлът се отваря незабавно с параметър, той се блокира, докато архивите не бъдат изтрити.

`Exceptions`

sourcePath’ is null.

Призователят няма изискваното разрешение за достъп.

UnauthorizedAccessException

code class=“paramref”>sourcePath’ е празен, съдържа само бели пространства, или съдържа невалидни знаци. - или - Име на файла, като част от name’, надвишава 100.

code class=“paramref”>sourcePath.

code class=“paramref”>sourcePath’, име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260 знака. - или - name’ е твърде дълго за xar.

NotSupportedException

code class=“paramref”>sourcePath.

Невъзможно е да се променят архивите.

`CreateEntry(Стрий, Стрий, XarCompressionSettings)`

Създаване на един вход в архива.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Името на входа.

source Stream

Входният поток за входа.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Входната инстанция.

`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.

Невъзможно е да се променят архивите.

`DeleteEntry(XarEntry)`

Премахва първото възникване на конкретен вход от списъка.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Входът трябва да бъде премахнат от списъка с вход.

`Returns`

XarArchive

Входната инстанция.

`Examples`

Ето как можете да премахнете всички записи, с изключение на последното:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

`Dispose()`

Извършва задачите, определени от приложението, свързани с освобождаването, изтеглянето или презареждането на неконтролирани ресурси.

public void Dispose()

`Dispose(Боул)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Трябва ли да се премахнат управляваните ресурси.

`ExtractToDirectory(Стрий)`

Извлича всички файлове в архива в предоставения каталог.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Пътят към директората за поставяне на извлечените файлове.

`Examples`

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Ако директорията не съществува, тя ще бъде създадена.

`Exceptions`

Пътят е нула

Windows, пътеките трябва да са по-малко от 248 символа и имената на файла трябва да са по-малко от 260.

Призователят не разполага с изискваното разрешение за достъп до съществуващата директория.

NotSupportedException

Ако директорията не съществува, маршрутът съдържа символ на колона (:) който не е част от етикета на диска (“C:”).

Пътят е лента с нулева дължина, съдържа само бяло пространство, или съдържа един или повече невалидни знаци. Можете да поискате за неподходящи символи, като използвате метода System.IO.Path.GetInvalid PathChars. -или- пътът е предварително фиксиран с или включва само един колонен знак (:).

Директорът, посочен по пътя, е файл. -или- Име на мрежата не е известно.

InvalidDataException

Архивите са корумпирани.

`Save(Стъпка, XarSaveOptions)`

Съхранява архиви към предоставения дестинационен файл.

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

`Parameters`

destinationFileName string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

saveOptions XarSaveOptions

Опции за съхранение на ARR архиви с.

`Exceptions`

destinationFileName’ is null.

Невъзможно е да се променят архивите.

`Save(Изтегляне, XarSaveOptions)`

Съхранява архиви към предоставения поток.

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

Пътят на дестинацията.

saveOptions XarSaveOptions

Опции за съхранение на ARR архиви с.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.