ZipArchive'a Giriş

Bir dosyayı sıkıştırılmış bir formatta göndermeyi düşündüğünüzde aklınıza gelen ilk şey genellikle bir Zip Arşivi olur. Bir zip arşivi, tek bir dosyayı veya tüm bir koleksiyonu tek bir arşivde sıkıştırmak ve paketlemek için popüler bir formattır. Ancak, arşivlenecek büyük dosya hacimleri olduğunda, onlarla çalışmak sıkıntı verici hale gelebilir çünkü bunları tek tek arşivlemek ve formatlamak zorunda kalabilirsiniz. Ama bunun böyle olması gerekmez. Büyük hacimli görevler programatik olarak otomasyon gerektirir. IronZIP, basit ama sezgisel bir kütüphane olarak tüm bunları ve daha fazlasını yapmamıza olanak tanır.

Bu makalede, IronZIP'in temel özellikleri ve işlevlerini ve iş akışınızı daha iyi otomatikleştirmenize, verimliliği artırmanıza ve hataya açık elle yapılan görevleri ortadan kaldırmanıza nasıl yardımcı olabileceğini kısaca tartışacağız.

Bir klasör veya dosyalardan yeni bir zip dosyası oluşturma

Aşağıda, birden çok dosyayı alıp bunları bir arşive zipleyip işlem sonrasında dışa aktaran bir örnek bulunmaktadır. Bu makaledeki tüm örnekler, tekrarlayan kod bloklarından kaçınmak için static void Main() yöntemiyle kapatılmıştır.

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Create an empty ZIP archive
        using (var archive = new IronZipArchive())
        {
            // Add files to the ZIP archive
            archive.Add("./assets/image1.jpg");
            archive.Add("./assets/image2.jpg");
            archive.Add("./assets/image3.jpg");

            // Export the ZIP archive to a file
            archive.SaveAs("output.zip");
        }
    }
}

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Create an empty ZIP archive
        using (var archive = new IronZipArchive())
        {
            // Add files to the ZIP archive
            archive.Add("./assets/image1.jpg");
            archive.Add("./assets/image2.jpg");
            archive.Add("./assets/image3.jpg");

            // Export the ZIP archive to a file
            archive.SaveAs("output.zip");
        }
    }
}

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create an empty ZIP archive
		Using archive = New IronZipArchive()
			' Add files to the ZIP archive
			archive.Add("./assets/image1.jpg")
			archive.Add("./assets/image2.jpg")
			archive.Add("./assets/image3.jpg")

			' Export the ZIP archive to a file
			archive.SaveAs("output.zip")
		End Using
	End Sub
End Class

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create an empty ZIP archive
		Using archive = New IronZipArchive()
			' Add files to the ZIP archive
			archive.Add("./assets/image1.jpg")
			archive.Add("./assets/image2.jpg")
			archive.Add("./assets/image3.jpg")

			' Export the ZIP archive to a file
			archive.SaveAs("output.zip")
		End Using
	End Sub
End Class

1. Önce IronZIP'i içe aktarıyoruz.
2. Ardından, IronZIP kullanarak bir arşiv oluşturuyoruz.
3. Arşive birden fazla dosya eklemek için archive.Add() çağırırız. Yol adlarının mutlak yollar olması gerektiğini unutmayın, aksi takdirde işlem ilgili dosyaları bulamaz.
4. Son olarak, zip arşivini output.zip olarak dışa aktarmak için archive.SaveAs() çağırırız.

Yeni dosyalar veya değişikliklerle mevcut bir zip dosyasını güncelleme

Başka bir örneği inceleyelim; bu sefer, IronZIP'in işlevselliğini sergilemek için mevcut zip arşivini yeni dosyalarla düzenleyeceğiz.

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Open an existing ZIP archive
        using (var archive = IronZipArchive.FromFile("existing.zip"))
        {
            // Add additional files to the existing ZIP archive
            archive.Add("./assets/image3.png");
            archive.Add("./assets/image4.png");

            // Export the updated ZIP archive to a new file
            archive.SaveAs("result.zip");
        }
    }
}

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Open an existing ZIP archive
        using (var archive = IronZipArchive.FromFile("existing.zip"))
        {
            // Add additional files to the existing ZIP archive
            archive.Add("./assets/image3.png");
            archive.Add("./assets/image4.png");

            // Export the updated ZIP archive to a new file
            archive.SaveAs("result.zip");
        }
    }
}

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Open an existing ZIP archive
		Using archive = IronZipArchive.FromFile("existing.zip")
			' Add additional files to the existing ZIP archive
			archive.Add("./assets/image3.png")
			archive.Add("./assets/image4.png")

			' Export the updated ZIP archive to a new file
			archive.SaveAs("result.zip")
		End Using
	End Sub
End Class

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Open an existing ZIP archive
		Using archive = IronZipArchive.FromFile("existing.zip")
			' Add additional files to the existing ZIP archive
			archive.Add("./assets/image3.png")
			archive.Add("./assets/image4.png")

			' Export the updated ZIP archive to a new file
			archive.SaveAs("result.zip")
		End Using
	End Sub
End Class

1. Önce IronZIP'i içe aktarıyoruz.
2. IronZIP kullanarak bir arşiv oluşturuyoruz, ancak bu sefer mevcut zip dosyasını IronZipArchive.FromFile() ile içe aktarıyoruz.
3. İstenen dosyaları arşive eklemek için archive.Add() çağırırız. Yol adlarının mutlak yollar olması gerektiğini unutmayın, aksi takdirde işlem mevcut dosyaları bulamaz.
4. Son olarak, güncellenmiş zip arşivini result.zip olarak dışa aktarmak için archive.SaveAs() çağırırız.

Yukarıdaki koddan da görebileceğiniz gibi, işlem ve format bir Zip dosyası oluşturmaya ve dosya eklemeye benzer. Temel fark, zip dosyasını içe aktarmamız ve böylece IronZIP'in basit ama sezgisel işlevselliğini sergilememizdir.

Bir Zip arşivinden dosyaları çıkarmak

Zip arşivinden veya Zip paketinden dosya çıkarmak için de IronZIP'i kullanabiliriz. Başka bir örnekte bu durumu inceleyelim.

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Extract the ZIP archive content to a specified directory
        IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted");
    }
}

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Extract the ZIP archive content to a specified directory
        IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted");
    }
}

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Extract the ZIP archive content to a specified directory
		IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted")
	End Sub
End Class

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Extract the ZIP archive content to a specified directory
		IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted")
	End Sub
End Class

IronZIP'i içe aktarırız ve IronZipArchive.ExtractArchiveToDirectory() çağırırız. Bu metod, mevcut zip arşivinin içeriğini belirtilen hedef dizine çıkartır.

Dahası, parola korumalı zip arşivleriyle başa çıkmanız gerektiğinde başka bir metod kullanarak arşivleri çıkartabiliriz.

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Extract the protected ZIP archive content to a specified directory
        IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted", "P@ssw0rd");
    }
}

using IronZip;

class Program
{
    static void Main(string[] args)
    {
        // Extract the protected ZIP archive content to a specified directory
        IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted", "P@ssw0rd");
    }
}

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Extract the protected ZIP archive content to a specified directory
		IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted", "P@ssw0rd")
	End Sub
End Class

Imports IronZip

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Extract the protected ZIP archive content to a specified directory
		IronZipArchive.ExtractArchiveToDirectory("output.zip", "extracted", "P@ssw0rd")
	End Sub
End Class

Sonunda, korunan zip arşivinin parolasını geçmemiz gereken başka bir parametre ekleriz. İşlemin geri kalanı yukarıda gösterildiği gibidir.

Gelişmiş Konular ve En İyi Uygulamalar

Yukarıda tartışılan arşiv ekleme, çıkarma ve oluşturma için kod örnekleri, zip arşivleriyle uğraşırken en yaygın olanıdır. Ancak, daha ileri düzeyde kullanım için, diğer formatları çıkartma veya yalnızca arşiv içeriğini görüntüleme gibi, IronZIP sizi daha fazlası ile karşılayacaktır.

IronZIP'in Gelişmiş Özellikleri

• Çapraz uyumluluk: IronZIP, standart (.NET Framework 4.6.2+), .NET Core (3.1+), ve Standard (2.0+) dahil olmak üzere geniş bir .NET sürümü yelpazesiyle uyumludur. Kütüphane ayrıca Web (Blazor), Mobil (MAUI), Masaüstü (WPF) ve Konsol üzerinde çalışır. Bu durum, geliştiricilerin platform ve sürüm sınırlamalarını aşmalarına olanak tanır.

• Arşiv Oluşturma: ZIP formatının ötesinde, IronZIP TAR, GZIP ve BZIP2 arşivleri oluşturmayı destekler.

• Arşiv Çıkarma: IronZIP ile tek kod bloğu kullanarak arşivleri ve dosyaları kolayca dekomprese edebilir ve çıkartabilirsiniz.

• Dosya ve Dosya Sistemlerini Ekleme: IronZIP, zip arşivlerini yöneterek görüntüler, metin dosyaları ve belgeleri (PDF, DOCX, XLSX gibi) ya da MP3 ve WAV gibi ses dosyalarını ekler. Hatta, bütün dosya sistemlerini veya bireysel metin dosyalarını bir ZipArchive arşivine sıkıştırabilir.

• Ekspor ve Oluştur: AES128 ve AES256 standartlarıyla arşivlere parola koruması ekleyebilirsiniz. Ayrıca, TAR, GZIP ve BZIP2 formatlarını üretebilir ve dışa aktarabilirsiniz.

• Özel Sıkıştırma Seviyeleri: IronZIP, geliştiricilerin algoritmalarını ihtiyaçlarına göre ayarlamak için sıkıştırma ayarlarını yapılandırmalarına olanak tanır.

• Arşiv Düzenleme: IronZIP, ilgili operasyonlar için kapsamlı bir çözüm olarak, arşiv içerisindeki dosya girdilerini kolayca ekleme, çıkartma veya silme işlemleri sağlar.

• Dosya Girdi Özellikleri: IronZIP, her dosya için belirli yorumlar bırakmanıza yardımcı olan, arşiv içindeki dosya adlarını çıkartmadan alma ve isteğe bağlı arşiv yorumları ayarlama özellikleri sağlar.

• Lisans Seçenekleri: IronZIP, tamamlayıcı deneme sürümleri içeren esnek lisanslama seçenekleri sunarak geliştiricilerin ihtiyaçlarına uygun olanı seçmelerine olanak tanır.

Sonuç

Sıkıştırılmış dosyalar ve arşivlerle uğraşmak geliştiricilerin sıkça karşılaştığı bir gündelik iştir ancak bunların büyük bir hacmini yönetmek stresli olabilir ve insan hatasına eğilimlidir. System.IO.Compression gibi seçenekler olmasına rağmen, IronZIP kullanarak sıkıştırılmış arşivlerle çalışırken daha fazlasını gerçekleştirmenizi ve sorunları hızla çözmenizi sağlar. Bu makalede, IronZIP'in gelişmiş özelliklerini ve zip arşivleri oluşturma, girdileri silme veya dosyalar ekleme gibi yaygın işlemleri tartıştık. IronZIP ile bu görevleri programlı bir şekilde nasıl gerçekleştireceğinizi anlamak, arşivlerin yönetiminde verimliliği, ölçeklenebilirliği ve otomasyonu artırır.