Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

이 클래스는 tar 아카이브 파일을 나타냅니다. tar 아카이브를 구성, 추출 또는 업데이트하는 데 사용합니다.

public class TarArchive : IArchive, IDisposable

상속

objectTarArchive

구현

IArchive, IDisposable

상속된 멤버

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

생성자

TarArchive()

Aspose.Zip.Tar.TarArchive 클래스의 새 인스턴스를 초기화합니다.

public TarArchive()

예제

다음 예제는 파일을 압축하는 방법을 보여줍니다.

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

TarArchive(Stream)

Aspose.Zip.Archive 클래스의 새 인스턴스를 초기화하고 아카이브에서 추출할 수 있는 항목 목록을 구성합니다.

public TarArchive(Stream sourceStream)

매개변수

sourceStream Stream

아카이브의 소스. 탐색 가능해야 합니다.

예제

다음 예제는 모든 항목을 디렉터리로 추출하는 방법을 보여줍니다.

using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

비고

이 생성자는 어떤 항목도 압축 해제하지 않습니다. 압축 해제를 위해 Aspose.Zip.Tar.TarEntry.Open 메서드를 참조하십시오.

예외

InvalidDataException

sourceStream가 탐색 가능하지 않습니다.

TarArchive(string)

Aspose.Zip.Tar.TarArchive 클래스의 새 인스턴스를 초기화하고 아카이브에서 추출할 수 있는 항목 목록을 구성합니다.

public TarArchive(string path)

매개변수

path string

아카이브 파일의 경로입니다.

예제

다음 예제는 모든 항목을 디렉터리로 추출하는 방법을 보여줍니다.

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

비고

이 생성자는 어떤 항목도 압축 해제하지 않습니다. 압축 해제를 위해 Aspose.Zip.Tar.TarEntry.Open 메서드를 참조하십시오.

예외

ArgumentNullException

path가 null입니다.

SecurityException

호출자가 액세스할 수 있는 권한이 없습니다.

ArgumentException

path가 비어 있거나 공백만 포함되거나 잘못된 문자를 포함하고 있습니다.

UnauthorizedAccessException

path 파일에 대한 액세스가 거부되었습니다.

PathTooLongException

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

NotSupportedException

path의 문자열 중간에 콜론(:)이 포함되어 있습니다.

FileNotFoundException

파일이 존재하지 않습니다.

DirectoryNotFoundException

지정된 경로가 잘못되었습니다. 예를 들어, 매핑되지 않은 드라이브에 있을 수 있습니다.

IOException

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

속성

Entries

아카이브를 구성하는 Aspose.Zip.Tar.TarEntry 유형의 항목을 가져옵니다.

public ReadOnlyCollection<tarentry> Entries { get; }

속성 값

ReadOnlyCollection<TarEntry&gt;

메서드

CreateEntries(DirectoryInfo, bool)

지정된 디렉터리의 모든 파일 및 디렉터리를 재귀적으로 아카이브에 추가합니다.

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

매개변수

directory DirectoryInfo

압축할 디렉터리입니다.

includeRootDirectory bool

루트 디렉터리 자체를 포함할지 여부를 나타냅니다.

반환

TarArchive

구성된 항목이 포함된 아카이브입니다.

예제

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

CreateEntries(string, bool)

지정된 디렉터리의 모든 파일 및 디렉터리를 재귀적으로 아카이브에 추가합니다.

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

매개변수

sourceDirectory string

압축할 디렉터리입니다.

includeRootDirectory bool

루트 디렉터리 자체를 포함할지 여부를 나타냅니다.

반환

TarArchive

구성된 항목이 포함된 아카이브입니다.

예제

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

예외

ArgumentNullException

sourceDirectory가 null입니다.

SecurityException

호출자가 sourceDirectory에 액세스할 수 있는 권한이 없습니다.

ArgumentException

sourceDirectory가 “, <, > 또는 |와 같은 잘못된 문자를 포함하고 있습니다.

PathTooLongException

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

CreateEntry(string, Stream, FileSystemInfo)

아카이브 내에서 단일 항목을 생성합니다.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

매개변수

name string

항목의 이름입니다.

source Stream

항목의 입력 스트림입니다.

fileInfo FileSystemInfo

압축할 파일 또는 폴더의 메타데이터입니다.

반환

TarEntry

Tar 항목 인스턴스입니다.

예제

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

비고

항목 이름은 name 매개변수 내에서만 설정됩니다. fileInfo 매개변수에 제공된 파일 이름은 항목 이름에 영향을 미치지 않습니다.

fileInfo는 항목이 디렉터리인 경우 System.IO.DirectoryInfo를 참조할 수 있습니다.

예외

PathTooLongException

name이 IEEE 1003.1-1998 표준에 따라 tar에 대해 너무 깁니다.

ArgumentException

name의 일부로서 파일 이름이 100자를 초과합니다.

CreateEntry(string, FileInfo, bool)

아카이브 내에서 단일 항목을 생성합니다.

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

매개변수

name string

항목의 이름입니다.

fileInfo FileInfo

압축할 파일 또는 폴더의 메타데이터입니다.

openImmediately bool

파일을 즉시 열면 true, 그렇지 않으면 아카이브 저장 시 파일을 엽니다.

반환

TarEntry

Tar 항목 인스턴스입니다.

예제

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

비고

항목 이름은 name 매개변수 내에서만 설정됩니다. fileInfo 매개변수에 제공된 파일 이름은 항목 이름에 영향을 미치지 않습니다.

fileInfo는 항목이 디렉터리인 경우 System.IO.DirectoryInfo를 참조할 수 있습니다.

파일이 openImmediately 매개변수로 즉시 열리면 아카이브가 폐기될 때까지 차단됩니다.

예외

PathTooLongException

name이 IEEE 1003.1-1998 표준에 따라 tar에 대해 너무 깁니다.

ArgumentException

name의 일부로서 파일 이름이 100자를 초과합니다.

CreateEntry(string, string, bool)

아카이브 내에서 단일 항목을 생성합니다.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

매개변수

name string

항목의 이름입니다.

path string

압축할 파일의 경로입니다.

openImmediately bool

파일을 즉시 열면 true, 그렇지 않으면 아카이브 저장 시 파일을 엽니다.

반환

TarEntry

Tar 항목 인스턴스입니다.

예제

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

비고

항목 이름은 name 매개변수 내에서만 설정됩니다. path 매개변수에 제공된 파일 이름은 항목 이름에 영향을 미치지 않습니다.

파일이 openImmediately 매개변수로 즉시 열리면 아카이브가 폐기될 때까지 차단됩니다.

예외

ArgumentNullException

path가 null입니다.

SecurityException

호출자가 액세스할 수 있는 권한이 없습니다.

ArgumentException

path가 비어 있거나 공백만 포함되거나 잘못된 문자를 포함하고 있습니다. - 또는 - name의 일부로서 파일 이름이 100자를 초과합니다.

UnauthorizedAccessException

path 파일에 대한 액세스가 거부되었습니다.

PathTooLongException

지정된 path, 파일 이름 또는 둘 다 시스템 정의 최대 길이를 초과합니다. - 또는 - name이 IEEE 1003.1-1998 표준에 따라 tar에 대해 너무 깁니다.

NotSupportedException

path의 문자열 중간에 콜론(:)이 포함되어 있습니다.

DeleteEntry(TarEntry)

항목 목록에서 특정 항목의 첫 번째 발생을 제거합니다.

public TarArchive DeleteEntry(TarEntry entry)

매개변수

entry TarEntry

항목 목록에서 제거할 항목입니다.

반환

TarArchive

항목이 삭제된 아카이브입니다.

예제

다음은 마지막 항목을 제외한 모든 항목을 제거하는 방법입니다:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

인덱스를 사용하여 항목 목록에서 항목을 제거합니다.

public TarArchive DeleteEntry(int entryIndex)

매개변수

entryIndex int

제거할 항목의 0 기반 인덱스입니다.

반환

TarArchive

항목이 삭제된 아카이브입니다.

예제

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

예외

ArgumentOutOfRangeException

entryIndex가 0보다 작습니다. - 또는 - entryIndexEntries 수와 같거나 큽니다.

Dispose()

비관리 리소스를 해제, 해제 또는 재설정하는 애플리케이션 정의 작업을 수행합니다.

public void Dispose()

Dispose(bool)

비관리 리소스를 해제, 해제 또는 재설정하는 애플리케이션 정의 작업을 수행합니다.

protected virtual void Dispose(bool disposing)

매개변수

disposing bool

관리 리소스를 해제해야 하는지 여부입니다.

ExtractToDirectory(string)

아카이브의 모든 파일을 제공된 디렉터리로 추출합니다.

public void ExtractToDirectory(string destinationDirectory)

매개변수

destinationDirectory string

추출된 파일을 배치할 디렉터리의 경로입니다.

예제

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

비고

디렉터리가 존재하지 않으면 생성됩니다.

예외

ArgumentNullException

path가 null입니다.

PathTooLongException

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

SecurityException

호출자가 기존 디렉터리에 액세스할 수 있는 권한이 없습니다.

NotSupportedException

디렉터리가 존재하지 않으면 경로에 드라이브 레이블(“C:")의 일부가 아닌 콜론(:) 문자가 포함되어 있습니다.

ArgumentException

path가 길이가 0인 문자열이거나 공백만 포함되거나 하나 이상의 잘못된 문자를 포함하고 있습니다. System.IO.Path.GetInvalidPathChars 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다. - 또는 - path가 접두사가 붙거나 콜론 문자(:)만 포함하고 있습니다.

IOException

지정된 경로의 디렉터리가 파일입니다. - 또는 - 네트워크 이름을 알 수 없습니다.

FromGZip(Stream)

제공된 gzip 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: gzip 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromGZip(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

GZip 추출 스트림은 압축 알고리즘의 특성상 탐색할 수 없습니다. Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

예외

InvalidDataException

아카이브가 손상되었습니다.

FromGZip(string)

제공된 gzip 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: gzip 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromGZip(string path)

매개변수

path string

아카이브 파일의 경로입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

GZip 추출 스트림은 압축 알고리즘의 특성상 탐색할 수 없습니다. Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

예외

InvalidDataException

아카이브가 손상되었습니다.

FromLZMA(Stream)

제공된 LZMA 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: LZMA 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromLZMA(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

LZMA 추출 스트림은 압축 알고리즘의 특성상 탐색할 수 없습니다. Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromLZMA(string)

제공된 LZMA 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: LZMA 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromLZMA(string path)

매개변수

path string

아카이브 파일의 경로입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

LZMA 추출 스트림은 압축 알고리즘의 특성상 탐색할 수 없습니다. Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromLZip(Stream)

제공된 lzip 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: lzip 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromLZip(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

Lzip 추출 스트림은 압축 알고리즘의 특성상 탐색할 수 없습니다. Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromLZip(string)

제공된 lzip 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: lzip 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromLZip(string path)

매개변수

path string

아카이브 파일의 경로입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

Lzip 추출 스트림은 압축 알고리즘의 특성상 탐색할 수 없습니다. Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromXz(Stream)

제공된 xz 형식 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: xz 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromXz(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromXz(string)

제공된 xz 형식 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: xz 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromXz(string path)

매개변수

path string

아카이브 파일의 경로입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromZ(Stream)

제공된 Z 형식 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: Z 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromZ(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromZ(string)

제공된 Z 형식 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: Z 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromZ(string path)

매개변수

path string

아카이브 파일의 경로입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

비고

Tar 아카이브는 임의의 레코드를 추출할 수 있는 기능을 제공하므로 내부적으로 탐색 가능한 스트림으로 작동해야 합니다.

FromZstandard(Stream)

제공된 Zstandard 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: Zstandard 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromZstandard(Stream source)

매개변수

source Stream

아카이브의 소스입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

예외

IOException

Zstandard 스트림이 손상되었거나 읽을 수 없습니다.

InvalidDataException

데이터가 손상되었습니다.

FromZstandard(string)

제공된 Zstandard 아카이브를 추출하고 추출된 데이터로부터 Aspose.Zip.Tar.TarArchive를 구성합니다.

중요: Zstandard 아카이브는 이 메서드 내에서 완전히 추출되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

public static TarArchive FromZstandard(string path)

매개변수

path string

아카이브 파일의 경로입니다.

반환

TarArchive

Aspose.Zip.Tar.TarArchive의 인스턴스입니다.

예외

IOException

Zstandard 스트림이 손상되었거나 읽을 수 없습니다.

InvalidDataException

데이터가 손상되었습니다.

Save(Stream, TarFormat?)

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

public void Save(Stream output, TarFormat? format = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

비고

output는 쓰기 가능해야 합니다.

예외

ArgumentException

output는 쓰기 가능하지 않습니다. - 또는 - output는 추출하는 스트림과 동일합니다. - 또는 - format의 형식 제한으로 인해 아카이브를 저장할 수 없습니다.

Save(string, TarFormat?)

지정된 경로에 아카이브를 저장합니다.

public void Save(string destinationFileName, TarFormat? format = null)

매개변수

destinationFileName string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

비고

아카이브를 로드한 경로와 동일한 경로에 아카이브를 저장하는 것이 가능합니다. 그러나 이 방법은 임시 파일로 복사하는 방식이므로 권장되지 않습니다.

예외

ArgumentException

destinationFileName가 길이가 0인 문자열이거나 공백만 포함되거나 하나 이상의 잘못된 문자를 포함하고 있습니다. System.IO.Path.InvalidPathChars로 정의된 잘못된 문자를 포함합니다.

ArgumentNullException

destinationFileName가 null입니다.

PathTooLongException

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

DirectoryNotFoundException

지정된 destinationFileName가 잘못되었습니다. (예: 매핑되지 않은 드라이브에 있습니다.)

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

UnauthorizedAccessException

destinationFileName가 읽기 전용 파일을 지정했으며 접근이 허용되지 않거나 - 또는 - 지정된 경로가 디렉터리입니다. - 또는 - 호출자가 필요한 권한이 없습니다.

NotSupportedException

destinationFileName가 잘못된 형식입니다.

FileNotFoundException

파일을 찾을 수 없습니다.

SaveGzipped(Stream, TarFormat?)

gzip 압축으로 스트림에 아카이브를 저장합니다.

public void SaveGzipped(Stream output, TarFormat? format = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

비고

output는 쓰기 가능해야 합니다.

예외

ArgumentNullException

output가 null입니다.

ArgumentException

output는 쓰기 가능하지 않습니다.

SaveGzipped(string, TarFormat?)

gzip 압축으로 경로에 아카이브를 저장합니다.

public void SaveGzipped(string path, TarFormat? format = null)

매개변수

path string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

LZMA 압축으로 스트림에 아카이브를 저장합니다.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

비고

output는 쓰기 가능해야 합니다.

중요: tar 아카이브는 이 메서드 내에서 구성된 후 압축되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

예외

ArgumentNullException

output가 null입니다.

ArgumentException

output는 쓰기 가능하지 않습니다.

SaveLZMACompressed(string, TarFormat?)

LZMA 압축으로 경로에 아카이브를 저장합니다.

public void SaveLZMACompressed(string path, TarFormat? format = null)

매개변수

path string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

비고

중요: tar 아카이브는 이 메서드 내에서 구성된 후 압축되며, 그 내용은 내부적으로 유지됩니다. 메모리 소비에 주의하십시오.

SaveLzipped(Stream, TarFormat?)

lzip 압축으로 스트림에 아카이브를 저장합니다.

public void SaveLzipped(Stream output, TarFormat? format = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

비고

output는 쓰기 가능해야 합니다.

예외

ArgumentNullException

output가 null입니다.

ArgumentException

output는 쓰기 가능하지 않습니다.

SaveLzipped(string, TarFormat?)

lzip 압축으로 경로에 아카이브를 저장합니다.

public void SaveLzipped(string path, TarFormat? format = null)

매개변수

path string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

xz 압축으로 스트림에 아카이브를 저장합니다.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

settings XzArchiveSettings

특정 xz 아카이브에 대한 설정 집합: 사전 크기, 블록 크기, 체크 유형입니다.

예제

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

비고

output는 쓰기 가능해야 합니다.

예외

ArgumentNullException

output가 null입니다.

ArgumentException

output는 쓰기 가능하지 않습니다.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

xz 압축으로 경로에 아카이브를 저장합니다.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

매개변수

path string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

settings XzArchiveSettings

특정 xz 아카이브에 대한 설정 집합: 사전 크기, 블록 크기, 체크 유형입니다.

예제

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

Z 압축으로 스트림에 아카이브를 저장합니다.

public void SaveZCompressed(Stream output, TarFormat? format = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

비고

output는 쓰기 가능해야 합니다.

예외

ArgumentNullException

output가 null입니다.

ArgumentException

output는 쓰기 가능하지 않습니다.

SaveZCompressed(string, TarFormat?)

Z 압축으로 경로에 아카이브를 저장합니다.

public void SaveZCompressed(string path, TarFormat? format = null)

매개변수

path string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

SaveZstandard(Stream, TarFormat?)

Zstandard 압축으로 스트림에 아카이브를 저장합니다.

public void SaveZstandard(Stream output, TarFormat? format = null)

매개변수

output Stream

대상 스트림입니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

비고

output는 쓰기 가능해야 합니다.

예외

ArgumentNullException

output가 null입니다.

ArgumentException

output는 쓰기 가능하지 않습니다.

SaveZstandard(string, TarFormat?)

Zstandard 압축으로 경로에 아카이브를 저장합니다.

public void SaveZstandard(string path, TarFormat? format = null)

매개변수

path string

생성할 아카이브의 경로입니다. 지정된 파일 이름이 기존 파일을 가리키면 덮어씌워집니다.

format TarFormat?

tar 헤더 형식을 정의합니다. null 값은 가능할 경우 USTar로 처리됩니다.

예제

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}
 한국어