Class XarArchive
이름 공간 : Aspose.Zip.Xar 모임: Aspose.Zip.dll (25.5.0)
이 클래스는 xar 파일을 나타냅니다.
public class XarArchive : IArchive, IDisposable
Inheritance
Implements
상속 회원들
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
sourceStream’ is null.
sourceStream’ is not seekable.
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
path’ is null.
호출자는 필요한 액세스 허가를 가지고 있지 않습니다.
path’는 텅 비어 있고, 흰색 공간만 포함하거나, 불가능한 문자를 포함합니다.
path" 파일에 대한 액세스는 거부됩니다.
지정된 path’, 파일 이름, 또는 둘 다 시스템에 의해 정의 된 최대 길이를 초과합니다.예를 들어, Windows 기반 플랫폼에서 경로는 248 문자 미만이어야하며 파일 이름은 260 문자 미만이어야합니다.
path’에 있는 파일에는 링의 중간에 있는 열(:)이 포함되어 있습니다.
파일은 찾을 수 없습니다.
지정된 경로는 불가능하며, 예를 들어 지정되지 않은 드라이브에 있습니다.
파일은 이미 열려 있습니다.
path’에 있는 파일은 유효하지 않습니다.
Properties
Entries
아카이브를 구성하는 Aspose.Zip.Xar.XarEntry 형식의 입력을 얻습니다.
public IEnumerable<xarentry> Entries { get; }
부동산 가치
IEnumerable <에 대한 정보 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
엑스 엔터테인먼트
Examples
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(@"C:\folder", false);
archive.Save(xarFile);
}
}
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, XarCompressionSettings)
아카이브에 모든 파일과 디렉토리를 주어진 디렉토리에 반복적으로 추가합니다.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)
Parameters
directory
DirectoryInfo
컴프레스를 위한 디렉토리
includeRootDirectory
bool
뿌리 디렉토리 자체를 포함하거나 포함하지 않는지 나타냅니다.
compressionSettings
XarCompressionSettings
압축 설정은 Aspose.Zip.Xar.XarEntry 항목을 추가하는 데 사용됩니다.
Returns
엑스 엔터테인먼트
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
directory’ is null.
호출자는 directory"에 액세스 할 수있는 필요한 허가를 가지고 있지 않습니다.
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
엑스 엔터테인먼트
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}
Remarks
파일이 파라미터로 즉시 열리면 파일이 삭제 될 때까지 차단됩니다.
Exceptions
name’ is null.
name’ is empty.
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
엑스 엔터테인먼트
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}
Remarks
입력 이름은 단지 파라미터 내에 설정됩니다.파라미터에 제공된 파일 이름은 입력 이름에 영향을 미치지 않습니다.
파일이 파라미터로 즉시 열리면 파일이 삭제 될 때까지 차단됩니다.
Exceptions
sourcePath’ is null.
호출자는 필요한 액세스 허가를 가지고 있지 않습니다.
sourcePath’는 텅 비어 있고, 단지 흰색 공간만 포함하거나, 불법 문자를 포함합니다. - 또는 - 파일 이름,
name’의 일부로서, 100 개 이상의 상징을 초과합니다.
sourcePath’ 파일에 대한 액세스는 거부됩니다.
지정된 sourcePath’, 파일 이름, 또는 둘 다 시스템에 의해 정의 된 최대 길이를 초과합니다. 예를 들어, Windows 기반 플랫폼에서 경로는 248 문자 미만이어야하며 파일 이름은 260 문자 미만이어야합니다. - 또는 -
name’는 xar에 너무 길다.
sourcePath’에 있는 파일에는 링의 중간에 있는 열(:)이 포함되어 있습니다.
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
엑스 엔터테인먼트
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.xar");
}
Exceptions
name’ is null.
source’ is null.
name’ is empty.
ARR 아카이브를 변경할 수 없습니다.
DeleteEntry(XarEntry)
입력 목록에서 특정 입력의 첫 번째 발생을 제거합니다.
public XarArchive DeleteEntry(XarEntry entry)
Parameters
entry
XarEntry
입력은 입력 목록에서 제거해야합니다.
Returns
엑스 엔터테인먼트
Examples
다음은 마지막을 제외한 모든 게시물을 제거하는 방법입니다 :
using (var archive = new XarArchive("archive.xar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}
Exceptions
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
길은 0
지정된 경로, 파일 이름 또는 둘 다 시스템에 의해 정의 된 최대 길이를 초과합니다.예를 들어, Windows 기반 플랫폼에서 경로는 248 문자 미만이어야하며 파일 이름은 260 문자 미만이어야합니다.
호출자는 기존 디렉토리에 액세스 할 수있는 필요한 허가를 가지고 있지 않습니다.
디렉토리가 존재하지 않는 경우, 경로는 드라이브 라벨의 일부가 아닌 척추 캐릭터 (:)를 포함합니다 (“C:”).
경로는 0 길이의 스트립, 단지 흰 공간을 포함, 또는 하나 이상의 무효 캐릭터를 포함합니다. 당신은 System.IO.Path.GetInvalidPathChars 방법을 사용하여 무효 캐릭터를 요청할 수 있습니다. -or- 경로는, 또는 포함, 단지 척추 캐릭터 (:).
경로에 의해 지정된 디렉토리는 파일입니다. -or- 네트워크 이름은 알려지지 않습니다.
아카이브가 부패했다.
Save(링크, XarSaveOptions)
제공된 목적지 파일에 아카이브를 저장합니다.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)
Parameters
destinationFileName
string
만약 지정된 파일 이름이 기존 파일을 지정한다면, 그것은 과장됩니다.
saveOptions
XarSaveOptions
옵션으로 xar 아카이브를 저장합니다.
Exceptions
destinationFileName’ is null.
ARR 아카이브를 변경할 수 없습니다.
Save(흐름, XarSaveOptions)
제공되는 스트림에 아카이브를 저장합니다.
public void Save(Stream output, XarSaveOptions saveOptions = null)
Parameters
output
Stream
목적지 흐름
saveOptions
XarSaveOptions
옵션으로 xar 아카이브를 저장합니다.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
ARR 아카이브를 변경할 수 없습니다.