Class XarArchive

Class XarArchive

İsim alanı : Aspose.Zip.Xar Toplama: Aspose.Zip.dll (25.5.0)

Bu sınıf bir xar arşiv dosyası temsil eder.

public class XarArchive : IArchive, IDisposable

Inheritance

object XarArchive

Implements

IArchive , IDisposable

mirasçı üyeleri

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 sınıfının yeni bir örneğini başlatır.

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

Varsayılan sıkıştırma ayarları, arşivdeki tüm girişlere uygulanır.

Examples

Aşağıdaki örnek, bir dosyayı nasıl sıkıştırılacağını gösterir.

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

XarArchive(Akış, XarLoadOptions)

Aspose.Zip.Xar.xarArchive sınıfının yeni bir örneğini başlatır ve arşivden çıkarılabilecek bir giriş listesi oluşturur.

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

Arşiv kaynağı, arama yapılmalıdır.

loadOptions XarLoadOptions

Arşiv yükleme seçenekleri ile.

Examples

Aşağıdaki örnek, tüm girişleri bir dizine nasıl çıkarılacağını gösterir.

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

Remarks

Bu üretici herhangi bir giriş paketlenmiyor. bakınız Aspose.Zip.Xar.XarFileEntry.Open yöntem paketlenmiyor.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(Çerçeve, XarLoadOptions)

Aspose.Zip.Xar.xarArchive sınıfının yeni bir örneğini başlatır ve arşivden çıkarılabilecek bir giriş listesi oluşturur.

public XarArchive(string path, XarLoadOptions loadOptions = null)

Parameters

path string

Arşiv dosyasına giden yol.

loadOptions XarLoadOptions

Arşiv yükleme seçenekleri ile.

Examples

Aşağıdaki örnek, tüm girişleri bir dizine nasıl çıkarılacağını gösterir.

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

Remarks

Bu üretici herhangi bir giriş paketlenmiyor. bakınız Aspose.Zip.Xar.XarFileEntry.Open yöntem paketlenmiyor.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Müşteri, gerekli izinleri almamaktadır.

ArgumentException

path’ boş, yalnızca beyaz alanlar içerir veya geçersiz karakterler içerir.

UnauthorizedAccessException

path" dosyasına erişim reddedilir.

PathTooLongException

Belirlenen path’, dosya adı, ya da her ikisi de sistem tarafından tanımlanan maksimum uzunluğu aşmaktadır. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden az olmalıdır ve dosya isimleri 260 karakterden az olmalıdır.

NotSupportedException

path’daki dosya, satırın ortasında bir sütun (:) içerir.

FileNotFoundException

Dosya bulunamadı.

DirectoryNotFoundException

Belirlenmiş yol geçersizdir, örneğin haritalmamış bir sürücü üzerinde olması.

IOException

Dosya zaten açıktır.

InvalidDataException

path’daki dosya geçerli bir xar arşivi değildir.

Properties

Entries

Arşiv oluşturan Aspose.Zip.Xar.XarEntry tipi girişleri alır.

public IEnumerable<xarentry> Entries { get; }

Mülkiyet Değer

IEnumerable &lt için; XarEntry >

Methods

CreateEntries(çubuk, bool, XarCompressionSettings)

Tüm dosyaları ve dizinleri verilen dizinlerde tekrar tekrar dosyaya eklemek.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

sourceDirectory string

Kompres için bir dizin.

includeRootDirectory bool

Kök dizininin kendisini içerip içermediğini gösterir.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry öğeleri için kullanılan sıkıştırma ayarları.

Returns

XarArchive

Giriş Adayları.

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

Çağrıcı, sourceDirectory’ye erişmek için gerekli izinlere sahip değildir.

ArgumentException

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

PathTooLongException

Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden daha az olmalıdır ve dosya isimleri 260 karakterden daha az olmalıdır.

IOException

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

CreateEntries(DirectoryInfo, bool, XarCompressionSettings)

Tüm dosyaları ve dizinleri verilen dizinlerde tekrar tekrar dosyaya eklemek.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

directory DirectoryInfo

Kompres için bir dizin.

includeRootDirectory bool

Kök dizininin kendisini içerip içermediğini gösterir.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry öğeleri için kullanılan sıkıştırma ayarları.

Returns

XarArchive

Giriş Adayları.

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

Çağrıcı, directory’ye erişmek için gerekli izin vermez.

IOException

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

CreateEntry(çubuk, FileInfo, bool, XarCompressionSettings)

Arşiv içinde tek bir giriş oluşturun.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

Giriş Adı

fileInfo FileInfo

Dosya veya klasör metadata sıkıştırılmalıdır.

openImmediately bool

Gerçek şu ki, dosyayı hemen açtığınızda, aksi takdirde dosyayı arşiv kaydında açın.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry öğesini eklemek için kullanılan sıkıştırma ayarları.

Returns

XarEntry

Giriş Adayları.

Examples

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

Remarks

Dosya parametrelerle hemen açılırsa, arşiv kaldırılana kadar kilitlenir.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(dikiş, dikiş, bool, XarCompressionSettings)

Arşiv içinde tek bir giriş oluşturun.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

Giriş Adı

sourcePath string

Dosyayı sıkıştırmanın yolları.

openImmediately bool

Gerçek şu ki, dosyayı hemen açtığınızda, aksi takdirde dosyayı arşiv kaydında açın.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry öğesini eklemek için kullanılan sıkıştırma ayarları.

Returns

XarEntry

Giriş Adayları.

Examples

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

Remarks

Parametrelerde belirtilen dosya adı yalnızca giriş adı içinde ayarlanır.

Dosya parametrelerle hemen açılırsa, arşiv kaldırılana kadar kilitlenir.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

Müşteri, gerekli izinleri almamaktadır.

ArgumentException

sourcePath’ boştur, yalnızca beyaz alanlar içerir veya geçersiz karakterler içerir. - veya - Dosya adı, name’nin bir parçası olarak, 100’ü aşar.

UnauthorizedAccessException

sourcePath’ dosyasına erişim reddedilir.

PathTooLongException

Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden daha az olmalıdır ve dosya isimleri 260 karakterden daha az olmalıdır. - veya - name’ xar için çok uzun.

NotSupportedException

sourcePath’daki dosya, satırın ortasında bir sütun (:) içerir.

InvalidOperationException

Arşiv değiştirmek mümkün değil.

CreateEntry(String, Akış, XarCompressionSettings)

Arşiv içinde tek bir giriş oluşturun.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

Parameters

name string

Giriş Adı

source Stream

Giriş için giriş akışı.

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry öğesini eklemek için kullanılan sıkıştırma ayarları.

Returns

XarEntry

Giriş Adayları.

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

Arşiv değiştirmek mümkün değil.

DeleteEntry(XarEntry)

Bir giriş listesinden belirli bir girişin ilk ortaya çıkmasını kaldırır.

public XarArchive DeleteEntry(XarEntry entry)

Parameters

entry XarEntry

Giriş listesinden kaldırılması gereken giriş.

Returns

XarArchive

Giriş Adayları.

Examples

İşte son yazıyı hariç tüm yazıları nasıl kaldırabilirsiniz:

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()

Yönetilmemiş kaynakların serbest bırakılması, serbest bırakılması veya yeniden düzenlenmesi ile ilişkili uygulama tanımlanmış görevleri yerine getirir.

public void Dispose()

Dispose(bool)

Yönetilmemiş kaynakların serbest bırakılması, serbest bırakılması veya yeniden düzenlenmesi ile ilişkili uygulama tanımlanmış görevleri yerine getirir.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Yönetilen kaynakların dağıtılması gerekmektedir.

ExtractToDirectory(Sırt)

Arşivdeki tüm dosyaları sağlanan dizine çıkarır.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Çekilen dosyaları yerleştirmek için dizine giden yol.

Examples

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

Remarks

Eğer katalog yoksa, oluşturulacaktır.

Exceptions

ArgumentNullException

yol sıfırdır

PathTooLongException

Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden az olmalıdır ve dosya isimleri 260 karakterden az olmalıdır.

SecurityException

Çağrıcı, mevcut dizinlere erişmek için gerekli izinlere sahip değildir.

NotSupportedException

Eğer dizin yoksa, yol bir sürücü etiketinin bir parçası olmayan bir kolon karakterini (:) içerir (“C:”).

ArgumentException

yol sıfır uzunluğundaki bir çizgidir, yalnızca beyaz alan içerir veya bir veya daha fazla olumsuz karakter içerir. Sistem.IO.Path.GetInvalidPathChars yöntemini kullanarak olumsuz karakterler için sorgulama yapabilirsiniz. -veya- yol sadece bir kolon karakter (:) ile önceden ayarlanmıştır veya içerir.

IOException

Yol tarafından belirtilen dizin bir dosyadır. -or- Ağ adı bilinmemektedir.

InvalidDataException

Arşiv bozulmuştur.

Save(Çerçeve, XarSaveOptions)

Arşivleri sağlanan hedef dosyasına kaydeder.

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

Parameters

destinationFileName string

Dosya adı belirlenmiş bir dosyaya işaret ederse, yeniden yazılacaktır.

saveOptions XarSaveOptions

Arşiv kaydetme seçenekleri ile.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

Arşiv değiştirmek mümkün değil.

Save(Akış, XarSaveOptions)

Arşivleri sağlanan akışa kaydeder.

public void Save(Stream output, XarSaveOptions saveOptions = null)

Parameters

output Stream

Amaç akışı.

saveOptions XarSaveOptions

Arşiv kaydetme seçenekleri ile.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

Arşiv değiştirmek mümkün değil.

 Türkçe