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
Implements
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
sourceStream’ is null.
sourceStream’ is not seekable.
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
path’ is null.
Müşteri, gerekli izinleri almamaktadır.
path’ boş, yalnızca beyaz alanlar içerir veya geçersiz karakterler içerir.
path" dosyasına erişim reddedilir.
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.
path’daki dosya, satırın ortasında bir sütun (:) içerir.
Dosya bulunamadı.
Belirlenmiş yol geçersizdir, örneğin haritalmamış bir sürücü üzerinde olması.
Dosya zaten açıktır.
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 < 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
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
sourceDirectory’ is null.
Çağrıcı, sourceDirectory’ye erişmek için gerekli izinlere sahip değildir.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden daha az olmalıdır ve dosya isimleri 260 karakterden daha az olmalıdır.
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
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
directory’ is null.
Çağrıcı, directory’ye erişmek için gerekli izin vermez.
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
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
name’ is null.
name’ is empty.
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
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
sourcePath’ is null.
Müşteri, gerekli izinleri almamaktadır.
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.
sourcePath’ dosyasına erişim reddedilir.
Ö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.
sourcePath’daki dosya, satırın ortasında bir sütun (:) içerir.
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
Giriş Adayları.
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.
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
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 > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}
Exceptions
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
yol sıfırdır
Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden az olmalıdır ve dosya isimleri 260 karakterden az olmalıdır.
Çağrıcı, mevcut dizinlere erişmek için gerekli izinlere sahip değildir.
Eğer dizin yoksa, yol bir sürücü etiketinin bir parçası olmayan bir kolon karakterini (:) içerir (“C:”).
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.
Yol tarafından belirtilen dizin bir dosyadır. -or- Ağ adı bilinmemektedir.
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
destinationFileName’ is null.
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
output’ is null.
output’Is not writable/readable or not seekable.
Arşiv değiştirmek mümkün değil.