Class SharArchive

호출자는 필요한 액세스 허가를 가지고 있지 않습니다.

UnauthorizedAccessException

path’는 텅 비어 있고, 흰색 공간만 포함하거나, 불가능한 문자를 포함합니다.

path" 파일에 대한 액세스는 거부됩니다.

DirectoryNotFoundException

지정된 path’, 파일 이름, 또는 둘 다 시스템에 의해 정의 된 최대 길이를 초과합니다.예를 들어, Windows 기반 플랫폼에서 경로는 248 문자 미만이어야하며 파일 이름은 260 문자 미만이어야합니다.

NotSupportedException

path’에 있는 파일에는 링의 중간에 있는 열(:)이 포함되어 있습니다.

FileNotFoundException

파일은 찾을 수 없습니다.

지정된 경로는 불가능하며, 예를 들어 지정되지 않은 드라이브에 있습니다.

파일은 이미 열려 있습니다.

`Properties`

`Entries`

그것은 아카이브를 구성하는 Aspose.Zip.Shar.SharEntry 형식의 입력을 얻습니다.

public ReadOnlyCollection<sharentry> Entries { get; }

`부동산 가치`

ReadOnlyCollection &lt에 대한 정보 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 |.

지정된 경로, 파일 이름 또는 둘 다 시스템에 의해 정의 된 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서 경로는 248 문자 미만이어야하며 파일 이름은 260 문자 미만이어야합니다. 지정된 경로, 파일 이름 또는 둘 다 너무 길다.

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

`CreateEntries(디렉토리Info, Bool)`

아카이브에 모든 파일과 디렉토리를 주어진 디렉토리에 반복적으로 추가합니다.

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(링크, FileInfo, Bool)`

아카이브 내에서 단일 입력을 만듭니다.

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’ 파일에 대한 액세스는 거부됩니다.

지정된 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

제거하려는 입력의 0 기반 지수.

`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

관리된 자원이 낭비되어야 한다.

`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

지정된 destinationFileName’, 파일 이름, 또는 둘 다 시스템에 의해 정의 된 최대 길이를 초과합니다.예를 들어, Windows 기반 플랫폼에서 경로는 248 문자 미만이어야하며 파일 이름은 260 문자 미만이어야합니다.

지정된 destinationFileName’는 무효입니다 (예를 들어, 그것은 지도되지 않은 드라이브에 있습니다).

UnauthorizedAccessException

파일을 열 때 I/O 오류가 발생했습니다.

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`

글쓰기가 있어야 합니다.

`Exceptions`

output’ is null.