Class ZArchive

Class ZArchive

이름 공간 : Aspose.Zip.Z 모임: Aspose.Zip.dll (25.5.0)

이 클래스는 Z (압축) 아카이브 파일을 나타냅니다.이를 사용하여 Z 아카이브를 구성하거나 추출합니다.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

상속 회원들

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

Remarks

참조 https://docs.fileformat.com/compression/z/

Constructors

아카이브()

압축을 위해 준비된 Aspose.Zip.Z.Archive 클래스의 새로운 사례를 시작합니다.

public ZArchive()

아카이브(스트림, ZArchiveLoadOptions)

Aspose.Zip.Z.Archive 클래스의 새로운 사례를 시작하여 압축을 위해 준비합니다.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

아카이브의 출처입니다.

loadOptions ZArchiveLoadOptions

아카이브를 업로드 할 수있는 옵션.

Remarks

이 건축기는 압축하지 않습니다. Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) 압축 방법을 참조하십시오.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

아카이브(링크, ZArchiveLoadOptions)

Aspose.Zip.Z.Archive 클래스의 새로운 사례를 시작하여 압축을 위해 준비합니다.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

아카이브의 출처로 가는 길.

loadOptions ZArchiveLoadOptions

아카이브를 업로드 할 수있는 옵션.

Remarks

이 건축기는 압축하지 않습니다. Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) 압축 방법을 참조하십시오.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

파일은 찾을 수 없습니다.

DirectoryNotFoundException

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

IOException

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

Methods

Dispose()

응용 프로그램으로 정의된 작업을 수행하며, 관리되지 않은 자원을 배출, 배출 또는 재배치하는 것과 관련이 있습니다.

public void Dispose()

Dispose(바울)

응용 프로그램으로 정의된 작업을 수행하며, 관리되지 않은 자원을 배출, 배출 또는 재배치하는 것과 관련이 있습니다.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

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

Extract(Stream)

Z 아카이브를 스트림으로 추출합니다.

public void Extract(Stream destination)

Parameters

destination Stream

압축된 데이터를 저장하기 위한 흐름.

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Exceptions

InvalidDataException

데이터는 압축되지 않습니다.

Extract(FileInfo)

파일에 Z 파일을 추출합니다.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo는 압축된 데이터를 저장합니다.

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Exceptions

SecurityException

호출자는 fileInfo"를 열 수있는 필요한 허가를 가지고 있지 않습니다.

ArgumentException

파일 경로는 비어 있거나 흰색 공간만 포함되어 있습니다.

FileNotFoundException

파일은 찾을 수 없습니다.

UnauthorizedAccessException

파일로 가는 길은 단순히 읽기 또는 디렉토리입니다.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

데이터는 압축되지 않습니다.

Extract(스트리트)

Z 파일을 경로에 따라 파일로 추출합니다.

public FileInfo Extract(string path)

Parameters

path string

삭제된 데이터를 저장하는 파일로 이동합니다.

Returns

FileInfo

추출된 파일에 대한 정보

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

데이터는 압축되지 않습니다.

ExtractToDirectory(스트리트)

아카이브의 내용을 제공된 디렉토리로 추출합니다.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

Save(스트림, ZArchiveSaveOptions)

제공되는 스트림에 xz 아카이브를 저장합니다.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

목적지 흐름

settings ZArchiveSaveOptions

아카이브 구성에 대한 옵션 설정.

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

찾을 수 있어야 합니다.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(링크, ZArchiveSaveOptions)

Z 파일을 제공된 목적지 파일에 저장합니다.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

파일 이름이 기존 파일을 지정하는 경우, 그것은 과장됩니다.

settings ZArchiveSaveOptions

아카이브 구성에 대한 옵션 설정.

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

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

ArgumentException

destinationFileName’는 텅 비어 있고, 단지 흰색 공간만 포함되어 있거나, 부적절한 문자를 포함합니다.

UnauthorizedAccessException

destinationFileName’ 파일에 대한 액세스는 거부됩니다.

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

아카이브 내에서 압축되어야 하는 콘텐츠를 설정합니다.

public void SetSource(Stream source)

Parameters

source Stream

아카이브에 대한 입력 스트림.

Examples

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

아카이브 내에서 압축되어야 하는 콘텐츠를 설정합니다.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo는 입력 스트림으로 열립니다.

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

Exceptions

SecurityException

호출자는 fileInfo"를 열 수있는 필요한 허가를 가지고 있지 않습니다.

ArgumentException

파일 경로는 비어 있거나 흰색 공간만 포함되어 있습니다.

FileNotFoundException

파일은 찾을 수 없습니다.

UnauthorizedAccessException

파일로 가는 길은 단순히 읽기 또는 디렉토리입니다.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

SetSource(스트리트)

아카이브 내에서 압축되어야 하는 콘텐츠를 설정합니다.

public void SetSource(string sourcePath)

Parameters

sourcePath string

입력 스트림으로 열릴 파일로 이동하는 경로.

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

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

ArgumentException

sourcePath’는 텅 비어 있고, 단지 흰색 공간만 포함되어 있거나, 부적절한 문자를 포함합니다.

UnauthorizedAccessException

sourcePath’ 파일에 대한 액세스는 거부됩니다.

PathTooLongException

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

NotSupportedException

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

 한국어