Class XarArchive
Namespace: Aspose.Zip.Xar
Assembly: Aspose.Zip.dll (25.1.0)
Bu sınıf xar arşiv dosyasını temsil eder.
public class XarArchive : IArchive, IDisposableMiras
Uygulamalar
Miras Alınan Üyeler
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Yapıcılar
XarArchive(XarCompressionSettings)
Aspose.Zip.Xar.XarArchive sınıfının yeni bir örneğini başlatır.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parametreler
defaultCompressionSettings XarCompressionSettings
Arşivdeki tüm girişlere uygulanacak varsayılan sıkıştırma ayarları.
Örnekler
Aşağıdaki örnek bir dosyanın nasıl sıkıştırılacağını göstermektedir.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(Stream, XarLoadOptions)
Aspose.Zip.Xar.XarArchive sınıfının yeni bir örneğini başlatır ve arşivden çıkarılabilecek girişler listesini oluşturur.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parametreler
sourceStream Stream
Arşivin kaynağı. Arşivlenebilir olmalıdır.
loadOptions XarLoadOptions
Arşivi yüklemek için kullanılacak seçenekler.
Örnekler
Aşağıdaki örnek, tüm girişlerin bir dizine nasıl çıkarılacağını göstermektedir.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Açıklamalar
Bu yapıcı herhangi bir girişi açmaz. Açma işlemi için Aspose.Zip.Xar.XarFileEntry.Open yöntemine bakın.
İstisnalar
sourceStream null.
sourceStream arşivlenebilir değil.
sourceStream geçerli bir xar arşivi değil.
XarArchive(string, XarLoadOptions)
Aspose.Zip.Xar.XarArchive sınıfının yeni bir örneğini başlatır ve arşivden çıkarılabilecek girişler listesini oluşturur.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parametreler
path string
Arşiv dosyasının yolu.
loadOptions XarLoadOptions
Arşivi yüklemek için kullanılacak seçenekler.
Örnekler
Aşağıdaki örnek, tüm girişlerin bir dizine nasıl çıkarılacağını göstermektedir.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Açıklamalar
Bu yapıcı herhangi bir girişi açmaz. Açma işlemi için Aspose.Zip.Xar.XarFileEntry.Open yöntemine bakın.
İstisnalar
path null.
Arayanın erişim için gerekli izni yok.
path boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.
path dosyasına erişim reddedildi.
Belirtilen path, dosya adı veya her ikisi sistem tanımlı maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
path içinde bir iki nokta üst üste (:) var.
Dosya bulunamadı.
Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde.
Dosya zaten açık.
path dosyası geçerli bir xar arşivi değil.
Özellikler
Entries
Arşivi oluşturan Aspose.Zip.Xar.XarEntry türündeki girişleri alır.
public IEnumerable<xarentry> Entries { get; }Özellik Değeri
IEnumerable<XarEntry>
Yöntemler
CreateEntries(string, bool, XarCompressionSettings)
Verilen dizindeki tüm dosya ve dizinleri özyinelemeli olarak arşive ekler.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parametreler
sourceDirectory string
Sıkıştırılacak dizin.
includeRootDirectory bool
Kök dizinin kendisinin dahil edilip edilmeyeceğini gösterir.
compressionSettings XarCompressionSettings
Eklenen Aspose.Zip.Xar.XarEntry öğeleri için kullanılan sıkıştırma ayarları.
Dönüşler
Xar giriş örneği.
Örnekler
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(@"C:\folder", false);
archive.Save(xarFile);
}
}İstisnalar
sourceDirectory null.
Arayanın sourceDirectory erişim için gerekli izni yok.
sourceDirectory geçersiz karakterler içeriyor, örneğin “, <, > veya |.
Belirtilen yol, dosya adı veya her ikisi sistem tanımlı maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır. Belirtilen yol, dosya adı veya her ikisi çok uzundur.
sourceDirectory bir dosyayı, değil bir dizini temsil eder.
CreateEntries(DirectoryInfo, bool, XarCompressionSettings)
Verilen dizindeki tüm dosya ve dizinleri özyinelemeli olarak arşive ekler.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parametreler
directory DirectoryInfo
Sıkıştırılacak dizin.
includeRootDirectory bool
Kök dizinin kendisinin dahil edilip edilmeyeceğini gösterir.
compressionSettings XarCompressionSettings
Eklenen Aspose.Zip.Xar.XarEntry öğeleri için kullanılan sıkıştırma ayarları.
Dönüşler
Xar giriş örneği.
Örnekler
using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
using (var archive = new XarArchive())
{
archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
archive.Save(xarFile);
}
}İstisnalar
directory null.
Arayanın directory erişim için gerekli izni yok.
directory bir dosyayı, değil bir dizini temsil eder.
CreateEntry(string, FileInfo, bool, XarCompressionSettings)
Arşiv içinde tek bir giriş oluşturur.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parametreler
name string
Girişin adı.
fileInfo FileInfo
Sıkıştırılacak dosya veya klasörün meta verileri.
openImmediately bool
Dosyayı hemen açmak için true, aksi takdirde dosya arşiv kaydedilirken açılır.
compressionSettings XarCompressionSettings
Eklenen Aspose.Zip.Xar.XarEntry öğesi için kullanılan sıkıştırma ayarları.
Dönüşler
Xar giriş örneği.
Örnekler
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}Açıklamalar
Dosya openImmediately parametresi ile hemen açılırsa, arşiv serbest bırakılana kadar engellenir.
İstisnalar
name null.
name boş.
fileInfo null.
CreateEntry(string, string, bool, XarCompressionSettings)
Arşiv içinde tek bir giriş oluşturur.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parametreler
name string
Girişin adı.
sourcePath string
Sıkıştırılacak dosyanın yolu.
openImmediately bool
Dosyayı hemen açmak için true, aksi takdirde dosya arşiv kaydedilirken açılır.
compressionSettings XarCompressionSettings
Eklenen Aspose.Zip.Xar.XarEntry öğesi için kullanılan sıkıştırma ayarları.
Dönüşler
Xar giriş örneği.
Örnekler
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}Açıklamalar
Giriş adı yalnızca name parametresi ile belirlenir. sourcePath parametresinde sağlanan dosya adı giriş adını etkilemez.
Dosya openImmediately parametresi ile hemen açılırsa, arşiv serbest bırakılana kadar engellenir.
İstisnalar
sourcePath null.
Arayanın erişim için gerekli izni yok.
sourcePath boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor. - veya - Dosya adı, name parametresinin bir parçası olarak 100 sembolü aşıyor.
sourcePath dosyasına erişim reddedildi.
Belirtilen sourcePath, dosya adı veya her ikisi sistem tanımlı maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır. - veya - name xar için çok uzundur.
sourcePath dosyası içinde bir iki nokta üst üste (:) var.
Xar arşivini değiştirmek imkansız.
CreateEntry(string, Stream, XarCompressionSettings)
Arşiv içinde tek bir giriş oluşturur.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parametreler
name string
Girişin adı.
source Stream
Giriş için giriş akışı.
compressionSettings XarCompressionSettings
Eklenen Aspose.Zip.Xar.XarEntry öğesi için kullanılan sıkıştırma ayarları.
Dönüşler
Xar giriş örneği.
Örnekler
using (var archive = new XarArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.xar");
}İstisnalar
name null.
source null.
name boş.
Xar arşivini değiştirmek imkansız.
DeleteEntry(XarEntry)
Girişler listesinden belirli bir girişin ilk örneğini kaldırır.
public XarArchive DeleteEntry(XarEntry entry)Parametreler
entry XarEntry
Girişler listesinden kaldırılacak giriş.
Dönüşler
Xar giriş örneği.
Örnekler
Tüm girişleri sonuncusu hariç nasıl kaldırabileceğinizi gösterir:
using (var archive = new XarArchive("archive.xar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}İstisnalar
entry null.
Dispose()
Yönetilmeyen kaynakların serbest bırakılması, boşaltılması veya sıfırlanması ile ilgili uygulama tanımlı görevleri yerine getirir.
public void Dispose()Dispose(bool)
Yönetilmeyen kaynakların serbest bırakılması, boşaltılması veya sıfırlanması ile ilgili uygulama tanımlı görevleri yerine getirir.
protected virtual void Dispose(bool disposing)Parametreler
disposing bool
Yönetilen kaynakların boşaltılıp boşaltılmayacağını belirtir.
ExtractToDirectory(string)
Arşivdeki tüm dosyaları sağlanan dizine çıkarır.
public void ExtractToDirectory(string destinationDirectory)Parametreler
destinationDirectory string
Çıkarılan dosyaların yerleştirileceği dizinin yolu.
Örnekler
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Açıklamalar
Dizin mevcut değilse, oluşturulacaktır.
İstisnalar
path null
Belirtilen yol, dosya adı veya her ikisi sistem tanımlı maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
Arayanın mevcut dizine erişim için gerekli izni yok.
Eğer dizin mevcut değilse, yol bir sürücü etiketinin (“C:") parçası olmayan bir iki nokta üst üste karakteri (:) içeriyorsa.
path sıfır uzunluğunda bir dize, yalnızca boşluk içeriyor veya bir veya daha fazla geçersiz karakter içeriyor. Geçersiz karakterleri sorgulamak için System.IO.Path.GetInvalidPathChars yöntemini kullanabilirsiniz. - veya - yol yalnızca bir iki nokta üst üste karakteri (:) ile başlıyorsa veya içeriyorsa.
Belirtilen yol bir dosyadır. - veya - Ağ adı bilinmiyor.
Arşiv bozulmuş.
Save(string, XarSaveOptions)
Arşivi sağlanan hedef dosyaya kaydeder.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parametreler
destinationFileName string
Oluşturulacak arşivin yolu. Belirtilen dosya adı mevcut bir dosyaya işaret ediyorsa, üzerine yazılacaktır.
saveOptions XarSaveOptions
Xar arşivini kaydetmek için kullanılacak seçenekler.
İstisnalar
destinationFileName null.
Xar arşivini değiştirmek imkansız.
Save(Stream, XarSaveOptions)
Arşivi sağlanan akışa kaydeder.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parametreler
output Stream
Hedef akış.
saveOptions XarSaveOptions
Xar arşivini kaydetmek için kullanılacak seçenekler.
İstisnalar
output null.
output yazılabilir/okunabilir değil veya arşivlenebilir değil.
Xar arşivini değiştirmek imkansız.
