Class XarArchive
Именује се: Aspose.Zip.Xar Асамблеја: Aspose.Zip.dll (25.5.0)
Ова класа представља архивни датотеку xar.
public class XarArchive : IArchive, IDisposable
Inheritance
Implements
Наслеђени чланови
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
sourceStream’ is null.
sourceStream’ is not seekable.
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
path’ is null.
Позивач нема захтеван дозволу за приступ.
path’ је празан, садржи само беле просторе, или садржи неважеће знакове.
Приступ датотеци path’ је одбијен.
На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотеке морају бити мање од 260 знакова.
Датотека у path’ садржи колону (:) у средини редове.
Датотека није пронађена.
Одређени пут је неважећи, на пример, да се налази на немапираном дискову.
Датотека је већ отворена.
Датотека у 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
КСНУМКС улазних инстанција.
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.
Позивач нема захтеван дозволу да приступи sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотека морају бити мање од 260 знакова.
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
КСНУМКС улазних инстанција.
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.
Позивач нема захтеван дозволу за приступ directory'.
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
КСНУМКС улазних инстанција.
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
КСНУМКС улазних инстанција.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}
Remarks
Име уноса је постављено само унутар параметара. име датотеке које је наведено у параметру не утиче на име уноса.
Ако се датотека одмах отвара са параметром, блокира се све док се архива не уклони.
Exceptions
sourcePath’ is null.
Позивач нема захтеван дозволу за приступ.
sourcePath’ је празан, садржи само беле просторе, или садржи невалидне знакове. - или - Име датотеке, као део
name’, прелази 100 симбола.
Приступ датотеци sourcePath’ је одбијен.
На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотека морају бити мање од 260 знакова. - или - name’ је превише дуг за xar.
Датотека у 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
КСНУМКС улазних инстанција.
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
КСНУМКС улазних инстанција.
Examples
Ево како можете уклонити све улоге осим последњег:
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()
Извршава апликације-дефинисане задатке повезане са ослобађањем, ослобађањем или рестаурацијом неконтролисаних ресурса.
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
Пут је нула
На пример, на платформима заснованим на Виндовсу, путеви морају бити мање од 248 знакова, а имена датотека морају бити мање од 260 знакова.
Позивач нема неопходне дозволе за приступ постојећем директоријуму.
Ако директоријум не постоји, пут садржи карактер колона (:) који није део етикета дискова (“Ц:”).
Пут је нуле дужине траке, садржи само бели простор, или садржи један или више невалидних знакова. можете да тражите невалидне знакове користећи метод System.IO.Path.GetInvalidPathChars. -или- Пут је префиксиран са, или садржи, само једну колону карактер (:).
Директоријум који је одређен путем је датотека. -или- Име мреже није познато.
Архив је корумпиран.
Save(КСНУМКС, КСНУМКС Опције)
Сачува архиве на датотеку дестинације која је обезбеђена.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)
Parameters
destinationFileName
string
Ако наведено име датотеке указује на постојећи датотеку, то ће бити преписано.
saveOptions
XarSaveOptions
Опције за сачување xar архива са.
Exceptions
destinationFileName’ is null.
Немогуће је модификовати архиве.
Save(Стрејм, XarSaveOptions)
Сачува архиве на пружену струју.
public void Save(Stream output, XarSaveOptions saveOptions = null)
Parameters
output
Stream
Дисциплинарни ток.
saveOptions
XarSaveOptions
Опције за сачување xar архива са.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
Немогуће је модификовати архиве.