Class SharArchive

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

UnauthorizedAccessException

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

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

DirectoryNotFoundException

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

NotSupportedException

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

FileNotFoundException

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

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

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

`Properties`

`Entries`

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

public ReadOnlyCollection<sharentry> Entries { get; }

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

ReadOnlyCollection < SharEntry >

`Methods`

`CreateEntries(КСНУМКС, Боол)`

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

public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

`Parameters`

sourceDirectory string

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

includeRootDirectory bool

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

`Returns`

Шар улаз инстанција.

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(sharFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

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

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

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

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

`CreateEntries(ДирективаИнфо, Боол)`

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

public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

`Parameters`

directory DirectoryInfo

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

includeRootDirectory bool

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

`Returns`

Шар улаз инстанција.

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(sharFile);
    }
}

`Exceptions`

directory’ is null.

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

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

`CreateEntry(Стринг, Филеинфо, Боол)`

Креирање јединственог улаза у архиву.

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`Parameters`

name string

Име улаза.

fileInfo FileInfo

Метадане датотеке или фасцикла да се компресирају.

openImmediately bool

Истина, ако отворите датотеку одмах, иначе отворите датотеку на архивом.

`Returns`

SharEntry

Шар улаз инстанција.

`Examples`

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

`Remarks`

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

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(Стринг, Стринг и Боол)`

Креирање јединственог улаза у архиву.

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

Име улаза.

sourcePath string

Пут да се дају да се компресирају.

openImmediately bool

Истина, ако отворите датотеку одмах, иначе отворите датотеку на архивом.

`Returns`

SharEntry

Шар улаз инстанција.

`Examples`

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

`Remarks`

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

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

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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

NotSupportedException

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

`CreateEntry(струја, струја)`

Креирање јединственог улаза у архиву.

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

Име улаза.

source Stream

Улазни ток за улазак.

`Returns`

SharEntry

Шар улаз инстанција.

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.shar");
}

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(SharEntry)`

Уклања прву појаву одређеног улаза са листе улаза.

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

Улаз да се уклони из листе улаза.

`Returns`

Шар улаз инстанција.

`Examples`

Ево како можете уклонити све улоге осим последњег:

using (var archive = new SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(Инт)`

Уклоните улаз са листе улаза по индексу.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Индекс нуле на основу улаза да се уклони.

`Returns`

ArgumentOutOfRangeException

Архив са улазом је избрисан.

`Examples`

using (var archive = new SharArchive("two_files.shar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.shar");
}

`Exceptions`

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

`Dispose(Боол)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Da li je potrebno iskoristiti upravljane resurse?

`Dispose()`

public void Dispose()

`Save(Стринг)`

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

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

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

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

`Remarks`

Могуће је сачувати архиву на исти пут од којих је преузета. међутим, ово се не препоручује јер овај приступ користи копирање на привремени датотеку.

`Exceptions`

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

destinationFileName’ is null.

DirectoryNotFoundException

Потврђена <код класа=“paramref”>дестинацијаFileName’ је немогућа, (на пример, она се налази на немапираном диску).

UnauthorizedAccessException

Појављује се грешка И/О приликом отварања датотеке.

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

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

`Save(Stream)`

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

public void Save(Stream output)

`Parameters`

output Stream

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

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

Mora da bude pismen.

`Exceptions`

output’ is null.