Class XarArchive

Class XarArchive

Именује се: Aspose.Zip.Xar Асамблеја: Aspose.Zip.dll (25.5.0)

Ова класа представља архивни датотеку xar.

public class XarArchive : IArchive, IDisposable

Inheritance

object XarArchive

Implements

IArchive , IDisposable

Наслеђени чланови

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

Constructors

XarArchive(XarCompressionSettings)

Иницијалише нову инстанцију класе Aspose.Zip.Xar.XarArchive.

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

Стандардне подешавања компресије, примењују се на све улоге архива.

Examples

Следећи пример показује како да компресирате датотеку.

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

XarArchive(Стрејм, XarLoadOptions)

Иницијалише нову инстанцију класе Aspose.Zip.Xar.xarArchive и саставља листу улаза која се може извући из архива.

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

Извор архива. мора бити траживо.

loadOptions XarLoadOptions

Опције за преузимање архива са.

Examples

Следећи пример показује како извући све улоге у директоријум.

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

Remarks

Овај градитељ не отпакује било који унос. погледајте Aspose.Zip.Xar.XarFileEntry.Open метод за отпаковање.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(КСНУМКС, КСНУМКС опције)

Иницијалише нову инстанцију класе 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

ArgumentNullException

path’ is null.

SecurityException

Позивач нема захтеван дозволу за приступ.

ArgumentException

path’ је празан, садржи само беле просторе, или садржи неважеће знакове.

UnauthorizedAccessException

Приступ датотеци path’ је одбијен.

PathTooLongException

На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотеке морају бити мање од 260 знакова.

NotSupportedException

Датотека у path’ садржи колону (:) у средини редове.

FileNotFoundException

Датотека није пронађена.

DirectoryNotFoundException

Одређени пут је неважећи, на пример, да се налази на немапираном дискову.

IOException

Датотека је већ отворена.

InvalidDataException

Датотека у path’ није важећи xar архива.

Properties

Entries

Добија улоге типа Aspose.Zip.Xar.XarEntry који чине архиву.

public IEnumerable<xarentry> Entries { get; }

Вредност имовине

IEnumerable < XarEntry >

Methods

CreateEntries(string, bool, XarCompressionСеттингс)

Додајте архиву све датотеке и директорије поновљено у датом директоријуму.

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

ArgumentNullException

sourceDirectory’ is null.

SecurityException

Позивач нема захтеван дозволу да приступи sourceDirectory'.

ArgumentException

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

PathTooLongException

На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотека морају бити мање од 260 знакова.

IOException

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

CreateEntries(DirectoryInfo, bool, XarCompressionСеттингс)

Додајте архиву све датотеке и директорије поновљено у датом директоријуму.

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

ArgumentNullException

directory’ is null.

SecurityException

Позивач нема захтеван дозволу за приступ directory'.

IOException

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

CreateEntry(string, 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

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

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

ArgumentNullException

sourcePath’ is null.

SecurityException

Позивач нема захтеван дозволу за приступ.

ArgumentException

sourcePath’ је празан, садржи само беле просторе, или садржи невалидне знакове. - или - Име датотеке, као део name’, прелази 100 симбола.

UnauthorizedAccessException

Приступ датотеци sourcePath’ је одбијен.

PathTooLongException

На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотека морају бити мање од 260 знакова. - или - name’ је превише дуг за xar.

NotSupportedException

Датотека у sourcePath’ садржи колону (:) у средини редове.

InvalidOperationException

Немогуће је модификовати архиве.

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

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

name’ is empty.

InvalidOperationException

Немогуће је модификовати архиве.

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

ArgumentNullException

entry’ is null.

Dispose()

Извршава апликације-дефинисане задатке повезане са ослобађањем, ослобађањем или рестаурацијом неконтролисаних ресурса.

public void Dispose()

Dispose(Боол)

Извршава апликације-дефинисане задатке повезане са ослобађањем, ослобађањем или рестаурацијом неконтролисаних ресурса.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Da li je potrebno iskoristiti upravljane resurse?

ExtractToDirectory(Стринг)

Екстрактира све датотеке у архиви у додатак директоријум.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Пут у директоријум да стави извучене датотеке у.

Examples

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

Remarks

Ако директоријум не постоји, он ће бити креиран.

Exceptions

ArgumentNullException

Пут је нула

PathTooLongException

На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотека морају бити мање од 260 знакова.

SecurityException

Позивач нема неопходне дозволе за приступ постојећем директоријуму.

NotSupportedException

Ако директоријум не постоји, пут садржи карактер колона (:) који није део етикета дискова (“Ц:”).

ArgumentException

Пут је нуле дужине траке, садржи само бели простор, или садржи један или више невалидних знакова. можете да тражите невалидне знакове користећи метод System.IO.Path.GetInvalidPathChars. -или- Пут је префиксиран са, или садржи, само једну колону карактер (:).

IOException

Директоријум који је одређен путем је датотека. -или- Име мреже није познато.

InvalidDataException

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

Save(КСНУМКС, КСНУМКС Опције)

Сачува архиве на датотеку дестинације која је обезбеђена.

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

Parameters

destinationFileName string

Ако наведено име датотеке указује на постојећи датотеку, то ће бити преписано.

saveOptions XarSaveOptions

Опције за сачување xar архива са.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

Немогуће је модификовати архиве.

Save(Стрејм, XarSaveOptions)

Сачува архиве на пружену струју.

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

Parameters

output Stream

Дисциплинарни ток.

saveOptions XarSaveOptions

Опције за сачување xar архива са.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

Немогуће је модификовати архиве.

 Српски