Tworzenie nowych archiwów ZIP za pomocą Aspose.ZIP for .NET

Biblioteka Aspose.ZIP for .NET umożliwia aplikacjom C# tworzenie plików ZIP bez 7-Zip, WinRAR ani innego zewnętrznego programu. Utwórz obiekt Archive, dodaj pliki jako wpisy i zapisz wynik do pliku lub strumienia z możliwością zapisu.

API obsługuje pojedynczy plik, całe drzewo katalogów oraz starannie dobrany pakiet. Nazwa pliku źródłowego i jego ścieżka w ZIP są kontrolowane niezależnie, dzięki czemu wynik ma przewidywalną i bezpieczną strukturę.

Przykład C#: tworzenie pliku ZIP

Utwórz nowy obiekt Archive, dodaj plik źródłowy metodą CreateEntry i zapisz ukończone archiwum ZIP.

Tworzenie pliku ZIP — C#

var dir = "full directory path";
using (var arch = new Archive())
{
   arch.CreateEntry("filename.txt", dir+"file.txt");
   arch.Save(dir+"archived_result.zip");
}

Instalowanie Aspose.ZIP for .NET

Zainstaluj pakiet NuGet Aspose.ZIP i dodaj odwołanie do projektu .NET. Pliki ZIP są tworzone bezpośrednio w procesie aplikacji.

Konsola Menedżera pakietów

PM> Install-Package Aspose.Zip

Tworzenie ZIP z jednego pliku

Utwórz Archive, wywołaj CreateEntry z docelową nazwą i ścieżką źródłową, a następnie zapisz archiwum. Ten wariant nadaje się do pakowania raportów, eksportów i wygenerowanych dokumentów.

Dodawanie wielu plików

Wywołaj CreateEntry dla każdego pliku źródłowego. Ścieżka źródłowa i nazwa wpisu są niezależne, dlatego pliki z różnych katalogów można logicznie uporządkować w ZIP.

Tworzenie ZIP z katalogu

Dodaj pliki znajdujące się pod katalogiem źródłowym, zachowując bezpieczne ścieżki względne. Powstanie przenośne drzewo bez ujawniania lokalnych ścieżek bezwzględnych.

Zapisywanie ZIP do strumienia

Zapisz archiwum do strumienia z możliwością zapisu, gdy jest zwracane z ASP.NET, przesyłane do chmury albo cały proces ma pozostać w pamięci bez pliku tymczasowego.

Jak działa tworzenie archiwum ZIP w C#

  1. Zainstaluj Aspose.ZIP for .NET i dodaj odwołanie do pakietu.
  2. Utwórz instancję Archive dla nowego kontenera ZIP.
  3. Dodaj pliki metodą CreateEntry albo dołącz zawartość katalogu.
  4. W razie potrzeby skonfiguruj kompresję lub szyfrowanie.
  5. Zapisz archiwum pod wskazaną ścieżką albo do strumienia z możliwością zapisu.
  6. Jawnie zwolnij zasoby archiwum i otwartych strumieni.

Archiwum jest finalizowane podczas zapisu. Najpierw dodaj wszystkie planowane wpisy, aby katalog centralny prawidłowo opisywał pełną zawartość ZIP.

Kontrolowanie nazw plików i struktury katalogów w ZIP

Ścieżka źródłowa wskazuje, skąd aplikacja odczytuje plik, natomiast nazwa wpisu określa jego położenie w ZIP. Rozdzielenie tych wartości pozwala zmieniać nazwy, tworzyć katalogi wirtualne i nie ujawniać lokalnych nazw katalogów.

Dla wpisów zagnieżdżonych używaj ukośników, na przykład documents/2026/report.pdf. Odrzucaj ścieżki bezwzględne, segmenty ../, puste nazwy i niezamierzone duplikaty pochodzące od użytkowników lub systemów zewnętrznych.

Tworzenie archiwum ZIP chronionego hasłem

Aspose.ZIP obsługuje tradycyjny algorytm ZipCrypto oraz szyfrowanie AES z kluczami 128-, 192- i 256-bitowymi. Preferuj AES, jeżeli program odbiorcy je obsługuje; ZipCrypto wybieraj tylko dla zgodności ze starszymi narzędziami.

Hasła pobieraj z bezpiecznej konfiguracji, nie zapisuj ich w kodzie ani dziennikach i przekazuj innym kanałem niż archiwum. Utraconego hasła nie można odzyskać za pomocą API.

Wybieranie sposobu kompresji wpisów ZIP

Deflate jest praktycznym ustawieniem domyślnym dla szeroko zgodnych archiwów ZIP. Zależnie od oprogramowania odbiorcy wpisy mogą również używać BZip2, LZMA, PPMd albo trybu bez kompresji. Ostatni wariant jest przydatny dla wcześniej skompresowanych danych, gdy szybkość pakowania jest ważniejsza niż niewielka redukcja rozmiaru.

Pliki JPEG, MP4 i wiele dokumentów pakietów biurowych są już skompresowane i mogą zmniejszyć się nieznacznie. Nadal warto połączyć je w jeden ZIP ze spójnymi nazwami, katalogami i ochroną dostępu.

Tworzenie ZIP a kompresowanie, rozpakowywanie i przeglądanie

CelWłaściwy procesOczekiwany wynik
Utworzenie nowego ZIP z plików lub katalogówUtwórz ZIP — ta stronaNowy ZIP zawierający wybrane wpisy
Zmniejszenie pliku lub utworzenie innego typu archiwumKompresowanie plików w C#Skompresowane dane lub inny kontener
Odzyskanie plików z istniejącego archiwumRozpakowywanie archiwów w C#Oryginalne pliki zapisane do ścieżki lub strumienia
Sprawdzenie wpisów bez rozpakowywaniaPrzeglądanie zawartości archiwumLista nazw wpisów i dostępnych metadanych
Dodanie lub zmiana ochrony archiwumOchrona archiwum hasłemZaszyfrowane archiwum wymagające prawidłowych danych dostępu

Dodanie pliku PDF, DOCX, PNG lub innego do ZIP nie konwertuje jego formatu wewnętrznego. Oryginalny plik staje się wpisem nowego archiwum.

Wskazówki produkcyjne dotyczące tworzenia ZIP

- Zawsze jawnie zwalniaj zasoby archiwów i strumieni, szczególnie w usługach tworzących wiele pakietów. - Zapisuj do strumienia przy zwracaniu archiwum ZIP z ASP.NET lub przechowywaniu go w chmurze. - Weryfikuj ścieżki, nazwy wpisów, liczbę plików i łączny rozmiar niezaufanych danych wejściowych. - Najpierw zapisuj do lokalizacji tymczasowej, a cel zastępuj dopiero po pomyślnym zakończeniu. - Nie zastępuj istniejącego archiwum bez wyraźnej zgody aplikacji. - Normalizuj kolejność wpisów, nazwy i znaczniki czasu, gdy wymagany jest powtarzalny wynik ZIP.

Tworzenie archiwów ZIP z popularnych typów plików

Skorzystaj z przewodników dla poszczególnych formatów, aby zobaczyć przykłady dopasowane do najczęściej pakowanych danych. Format źródłowy pozostaje w ZIP bez zmian; każdy przewodnik koncentruje się na utworzeniu i uporządkowaniu archiwum.

Tworzenie plików ZIP online

Potrzebujesz ZIP bez pisania kodu? Użyj bezpłatnego internetowego kreatora ZIP w przeglądarce.

  Nie jest potrzebny żaden program do archiwizacji na komputerze.
  Nie jest potrzebny kod ani konfiguracja API.
  Prześlij jeden lub wiele plików źródłowych.
  Pobierz utworzone archiwum ZIP.

Materiały dotyczące Aspose.ZIP for .NET

Często zadawane pytania

1. Jak utworzyć plik ZIP w C#?

Utwórz Archive, dodaj plik źródłowy metodą CreateEntry i wywołaj Save ze ścieżką wyjściową lub strumieniem. Pierwszy przykład pokazuje kompletny proces.

2. Czy mogę dodać wiele plików do jednego archiwum ZIP?

Tak. Wywołaj CreateEntry raz dla każdego pliku i zapisz archiwum po dodaniu wszystkich wpisów.

3. Czy mogę utworzyć ZIP z całego katalogu?

Tak. Dodaj pliki znajdujące się pod katalogiem i użyj bezpiecznych względnych nazw wpisów, aby zachować wymaganą strukturę.

4. Czy w .NET można utworzyć ZIP zaszyfrowany algorytmem AES?

Tak. Skonfiguruj wpisy z szyfrowaniem AES-128, AES-192 lub AES-256 i pobierz hasło z bezpiecznej konfiguracji aplikacji.

5. Czy do tworzenia ZIP jest potrzebny 7-Zip lub WinRAR?

Nie. Aspose.ZIP tworzy archiwum bezpośrednio w aplikacji .NET bez uruchamiania zewnętrznego oprogramowania.