Class ZstandardArchive
Namespace: Aspose.Zip.Zstandard
Assembly: Aspose.Zip.dll (25.1.0)
Bu sınıf, Zstandard arşiv dosyasını temsil eder. Zstandard arşivleri oluşturmak için kullanın.
public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntryMiras
Uygulamalar
IArchive, IDisposable, IArchiveFileEntry
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
ZstandardArchive()
Aspose.Zip.Zstandard.ZstandardArchive sınıfının sıkıştırma için hazırlanmış yeni bir örneğini başlatır.
public ZstandardArchive()Örnekler
Aşağıdaki örnek bir dosyayı nasıl sıkıştıracağınızı gösterir.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(Stream, ZstandardLoadOptions)
Aspose.Zip.Zstandard.ZstandardArchive sınıfının açma için hazırlanmış yeni bir örneğini başlatır.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parametreler
sourceStream Stream
Arşivin kaynağı.
options ZstandardLoadOptions
Arşivi yüklemek için kullanılacak seçenekler.
Örnekler
Bir akıştan arşivi açın ve bir MemoryStream içine çıkarın.
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Açıklamalar
Bu yapıcı sıkıştırma işlemi yapmaz. Sıkıştırma için Aspose.Zip.Zstandard.ZstandardArchive.Open yöntemine bakın.
ZstandardArchive(string, ZstandardLoadOptions)
Aspose.Zip.Zstandard.ZstandardArchive sınıfının yeni bir örneğini başlatır.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parametreler
path string
Arşiv dosyasının yolu.
options ZstandardLoadOptions
Arşivi yüklemek için kullanılacak seçenekler.
Örnekler
Yol ile bir dosyadan arşivi açın ve bir MemoryStream içine çıkarın.
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Açıklamalar
Bu yapıcı sıkıştırma işlemi yapmaz. Sıkıştırma için Aspose.Zip.Zstandard.ZstandardArchive.Open yöntemine bakın.
İstisnalar
path null.
Çağrıcı, erişim için gerekli izne sahip değildir.
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 tarafından tanımlanan maksimum uzunluğu aşmaktadır. Ö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 kolon (:) içeriyor.
Yöntemler
Dispose()
Yönetilmeyen kaynakları serbest bırakma, boşaltma veya sıfırlama ile ilgili uygulama tanımlı görevleri yerine getirir.
public void Dispose()Dispose(bool)
Yönetilmeyen kaynakları serbest bırakma, boşaltma veya sıfırlama 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.
Extract(Stream)
Arşivi sağlanan akışa çıkarır.
public void Extract(Stream destination)Parametreler
destination Stream
Hedef akış. Yazılabilir olmalıdır.
Örnekler
using (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}İstisnalar
destination yazmayı desteklemiyor.
Extract(string)
Arşivi yol ile dosyaya çıkarır.
public FileInfo Extract(string path)Parametreler
path string
Hedef dosyanın yolu. Dosya zaten varsa, üzerine yazılacaktır.
Dönüşler
Çıkarılan dosyanın bilgileri.
İstisnalar
path null.
Çağrıcı, erişim için gerekli izne sahip değildir.
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 tarafından tanımlanan maksimum uzunluğu aşmaktadır. Ö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 kolon (:) içeriyor.
ExtractToDirectory(string)
Arşivin içeriğini sağlanan dizine çıkarır.
public void ExtractToDirectory(string destinationDirectory)Parametreler
destinationDirectory string
Çıkarılan dosyaların yerleştirileceği dizinin yolu.
Açıklamalar
Dizin mevcut değilse, oluşturulacaktır.
İstisnalar
destinationDirectory null.
Belirtilen yol, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşmaktadır. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
Çağrıcı, mevcut dizine erişim için gerekli izne sahip değildir.
Dizin mevcut değilse, yol bir sürücü etiketinin (“C:") parçası olmayan bir kolon karakteri (:) içeriyor.
destinationDirectory 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 karakterler için System.IO.Path.GetInvalidPathChars yöntemini kullanarak sorgulama yapabilirsiniz.
-veya- yol, yalnızca bir kolon karakteri (:) ile başlıyor veya içeriyor.
Belirtilen yol dizin bir dosyadır. -veya- Ağ adı bilinmiyor.
Open()
Arşivi çıkarma için açar ve arşiv içeriği ile bir akış sağlar.
public Stream Open()Dönüşler
Arşivin içeriğini temsil eden akış.
Örnekler
Arşivi çıkarır ve çıkarılan içeriği dosya akışına kopyalar.
using (var archive = new ZstandardArchive("archive.zst"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}.NET 4.0 ve üzeri için Stream.CopyTo yöntemini kullanabilirsiniz: `unpacked.CopyTo(extracted);`
Açıklamalar
Orijinal dosyanın içeriğini almak için akıştan okuyun. Örnekler bölümüne bakın.
Save(Stream, ZstandardSaveOptions)
Arşivi sağlanan akışa kaydeder.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parametreler
outputStream Stream
Hedef akış.
settings ZstandardSaveOptions
Arşiv oluşturma için isteğe bağlı ayarlar.
Örnekler
Sıkıştırılmış verileri http yanıt akışına yazar.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Açıklamalar
outputStream yazılabilir olmalıdır.
İstisnalar
outputStream yazılabilir değil.
Kaynak sağlanmamıştır.
Save(string, ZstandardSaveOptions)
Arşivi sağlanan hedef dosyaya kaydeder.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parametreler
destinationFileName string
Oluşturulacak arşivin yolu. Belirtilen dosya adı mevcut bir dosyaya işaret ediyorsa, üzerine yazılacaktır.
settings ZstandardSaveOptions
Arşiv oluşturma için isteğe bağlı ayarlar.
Örnekler
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}İstisnalar
destinationFileName null.
Çağrıcı, erişim için gerekli izne sahip değildir.
destinationFileName boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.
destinationFileName dosyasına erişim reddedildi.
Belirtilen destinationFileName, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşmaktadır. Örneğin, Windows tabanlı platformlarda, yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
destinationFileName içinde bir kolon (:) içeriyor.
Save(FileInfo, ZstandardSaveOptions)
Arşivi sağlanan hedef dosyaya kaydeder.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parametreler
destination FileInfo
Hedef akış olarak açılacak FileInfo.
settings ZstandardSaveOptions
Arşiv oluşturma için isteğe bağlı ayarlar.
Örnekler
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}İstisnalar
Çağrıcı, destination açmak için gerekli izne sahip değildir.
Dosya yolu boş veya yalnızca boşluk içeriyor.
Dosya bulunamadı.
Dosya yolu salt okunur veya bir dizindir.
destination null.
Belirtilen yol geçersizdir, örneğin, haritalanmamış bir sürücüde bulunuyorsa.
Dosya zaten açık.
SetSource(Stream)
Arşiv içinde sıkıştırılacak içeriği ayarlar.
public void SetSource(Stream source)Parametreler
source Stream
Arşiv için giriş akışı.
Örnekler
using (var archive = new ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
Arşiv içinde sıkıştırılacak içeriği ayarlar.
public void SetSource(FileInfo fileInfo)Parametreler
fileInfo FileInfo
Sıkıştırılacak bir dosyaya referans.
Örnekler
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(string)
Arşiv içinde sıkıştırılacak içeriği ayarlar.
public void SetSource(string path)Parametreler
path string
Sıkıştırılacak dosyanın yolu.
Örnekler
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}İstisnalar
path null.
Çağrıcı, erişim için gerekli izne sahip değildir.
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 tarafından tanımlanan maksimum uzunluğu aşmaktadır. Ö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 kolon (:) içeriyor.
