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#
- Zainstaluj Aspose.ZIP for .NET i dodaj odwołanie do pakietu.
- Utwórz instancję
Archivedla nowego kontenera ZIP. - Dodaj pliki metodą
CreateEntryalbo dołącz zawartość katalogu. - W razie potrzeby skonfiguruj kompresję lub szyfrowanie.
- Zapisz archiwum pod wskazaną ścieżką albo do strumienia z możliwością zapisu.
- 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
| Cel | Właściwy proces | Oczekiwany wynik |
|---|---|---|
| Utworzenie nowego ZIP z plików lub katalogów | Utwórz ZIP — ta strona | Nowy ZIP zawierający wybrane wpisy |
| Zmniejszenie pliku lub utworzenie innego typu archiwum | Kompresowanie plików w C# | Skompresowane dane lub inny kontener |
| Odzyskanie plików z istniejącego archiwum | Rozpakowywanie archiwów w C# | Oryginalne pliki zapisane do ścieżki lub strumienia |
| Sprawdzenie wpisów bez rozpakowywania | Przeglądanie zawartości archiwum | Lista nazw wpisów i dostępnych metadanych |
| Dodanie lub zmiana ochrony archiwum | Ochrona archiwum hasłem | Zaszyfrowane 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.Przewodniki według typu pliku źródłowego
Dodawaj dokumenty, obrazy, arkusze, multimedia i inne pliki do nowego archiwum ZIP.
Tworzenie plików ZIP online
Potrzebujesz ZIP bez pisania kodu? Użyj bezpłatnego internetowego kreatora ZIP w przeglądarce.
Materiały dotyczące Aspose.ZIP for .NET
- Przegląd produktu
- Dokumentacja dla programistów
- Dokumentacja API
Archive - Dokumentacja API
ArchiveEntry - Przykłady C# w serwisie GitHub
- Pakiet Aspose.ZIP w NuGet
- Tworzenie archiwum z jednego lub wielu plików
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.