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(링크, 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

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

파일은 찾을 수 없습니다.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

path’에 있는 파일은 유효하지 않습니다.

Properties

Entries

아카이브를 구성하는 Aspose.Zip.Xar.XarEntry 형식의 입력을 얻습니다.

public IEnumerable<xarentry> Entries { get; }

부동산 가치

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

ArgumentNullException

sourceDirectory’ is null.

SecurityException

호출자는 sourceDirectory"에 액세스 할 수있는 필요한 허가가 없습니다.

ArgumentException

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

PathTooLongException

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

IOException

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

ArgumentNullException

directory’ is null.

SecurityException

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

IOException

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

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(스트리트, 스트리트, 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

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

NotSupportedException

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

InvalidOperationException

ARR 아카이브를 변경할 수 없습니다.

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

ARR 아카이브를 변경할 수 없습니다.

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

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

ExtractToDirectory(스트리트)

아카이브에 있는 모든 파일을 제공된 디렉토리로 추출합니다.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

디렉토리로 이동하여 추출된 파일을 입력합니다.

Examples

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

Remarks

디렉토리가 존재하지 않는다면, 그것은 만들어집니다.

Exceptions

ArgumentNullException

길은 0

PathTooLongException

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

SecurityException

호출자는 기존 디렉토리에 액세스 할 수있는 필요한 허가를 가지고 있지 않습니다.

NotSupportedException

디렉토리가 존재하지 않는 경우, 경로는 드라이브 라벨의 일부가 아닌 척추 캐릭터 (:)를 포함합니다 (“C:”).

ArgumentException

경로는 0 길이의 스트립, 단지 흰 공간을 포함, 또는 하나 이상의 무효 캐릭터를 포함합니다. 당신은 System.IO.Path.GetInvalidPathChars 방법을 사용하여 무효 캐릭터를 요청할 수 있습니다. -or- 경로는, 또는 포함, 단지 척추 캐릭터 (:).

IOException

경로에 의해 지정된 디렉토리는 파일입니다. -or- 네트워크 이름은 알려지지 않습니다.

InvalidDataException

아카이브가 부패했다.

Save(링크, XarSaveOptions)

제공된 목적지 파일에 아카이브를 저장합니다.

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

Parameters

destinationFileName string

만약 지정된 파일 이름이 기존 파일을 지정한다면, 그것은 과장됩니다.

saveOptions XarSaveOptions

옵션으로 xar 아카이브를 저장합니다.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

ARR 아카이브를 변경할 수 없습니다.

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

ARR 아카이브를 변경할 수 없습니다.

 한국어