Формат 7Z є популярним вибором для компресії та розповсюдження високого рівня. з Aspose.ZIP для .NET, ви можете створювати 7z архіви програматично за допомогою простих, сучасних API. Цей посібник проходить через мінімальний робочий приклад і додає практичні шаблони для реальних проектів, такі як додавання файлів з диска, стрімування даних з пам’яті, керування ім’ям входу та папорами всередині архіву, а також основного обробки помилок.

Всі зразки коду є внутрішніми і самоконтентованими.

Передумови

  • .NET 6 або більше
  • Новий пакет Aspose.Zip
dotnet add package Aspose.Zip

Названі простіри, що використовуються в зразках:Aspose.Zip, Aspose.Zip.SevenZip

Швидкий старт: створення 7Z архіву з декількома файлами

Цей мінімальний приклад створює новий 7Z-архів в пам’яті, додає два входи і зберігає його на диску.

// File: Program.cs
using System;
using System.IO;
using System.Text;
using Aspose.Zip.SevenZip;

class Program
{
    static void Main()
    {
        var outputPath = "example.7z";

        using (var archive = new SevenZipArchive())
        {
            // Add a text file from memory
            using (var ms = new MemoryStream(Encoding.UTF8.GetBytes("Hello 7z from Aspose.ZIP")))
            {
                archive.CreateEntry("docs/readme.txt", ms);
            }

            // Add a file from disk
            var sourceFile = "report.pdf"; // ensure this file exists
            if (File.Exists(sourceFile))
            {
                using var fs = File.OpenRead(sourceFile);
                archive.CreateEntry("reports/2025/report.pdf", fs);
            }

            // Save the 7z archive
            using var outStream = File.Create(outputPath);
            archive.Save(outStream);
        }

        Console.WriteLine("Saved 7z: " + Path.GetFullPath(outputPath));
    }
}
  • Що потрібно знати *
  • SevenZipArchive Починається порожнеча, а потім зателефонує CreateEntry(entryName, stream) за пунктом .
  • Імена входу визначають структуру папки всередині архіву, наприклад: docs/readme.txt.
  • Ви можете прочитати будь-яку Stream, що корисно для даних, які ви генеруєте в пам’яті.

Додайте цілий папір дерева

Переходити каталог рецидивично, зберегти свою релативну структуру всередині архіву, і зберігати як .7z.

using System;
using System.IO;
using Aspose.Zip.SevenZip;

static class FolderTo7z
{
    public static void CreateFromFolder(string sourceDir, string output7z)
    {
        if (!Directory.Exists(sourceDir))
            throw new DirectoryNotFoundException(sourceDir);

        using var archive = new SevenZipArchive();

        var basePath = Path.GetFullPath(sourceDir);
        foreach (var filePath in Directory.GetFiles(basePath, "*", SearchOption.AllDirectories))
        {
            var relPath = Path.GetRelativePath(basePath, filePath)
                              .Replace(Path.DirectorySeparatorChar, '/'); // normalize to forward slashes

            using var fs = File.OpenRead(filePath);
            archive.CreateEntry(relPath, fs);
        }

        using var outStream = File.Create(output7z);
        archive.Save(outStream);
    }
}

// Usage
// FolderTo7z.CreateFromFolder(@"C:\data\input", "bundle.7z");

«Тіпс»

  • Користувати Path.GetRelativePath Для того, щоб зберегти внутрішній склад папки чистим.
  • Нормалізуйте маршрутні сепаратори, щоб просувати слайди для послідовних записів в архіві.

Завантажити великі файли безпечно

При додаванні великих файлів, поширюйте їх, а не буфруйте весь файл в пам’яті. File.OpenRead Якщо ви генеруєте контент на літаку, напишіть його на Stream і проходить цей потік безпосередньо до CreateEntry.

using System.IO;
using System.Text;
using Aspose.Zip.SevenZip;

static void AddGeneratedCsv(SevenZipArchive archive, string entryName)
{
    // Example generator that writes CSV rows in a forward-only fashion
    using var pipe = new MemoryStream();
    using var writer = new StreamWriter(pipe, Encoding.UTF8, leaveOpen: true);

    writer.WriteLine("id,name");
    for (int i = 1; i <= 1000; i++)
        writer.WriteLine($"{i},Item {i}");

    writer.Flush();
    pipe.Position = 0;

    archive.CreateEntry(entryName, pipe);
}

Організуйте вхід з помічником

Для більших робочих місць використовуйте невеликий помічник, щоб додати файли з загальним заздалегідь.

using System.IO;
using Aspose.Zip.SevenZip;

static class SevenZipHelpers
{
    public static void AddFile(SevenZipArchive archive, string rootPrefix, string fullPath)
    {
        var relName = Path.Combine(rootPrefix, Path.GetFileName(fullPath))
                           .Replace(Path.DirectorySeparatorChar, '/');
        using var fs = File.OpenRead(fullPath);
        archive.CreateEntry(relName, fs);
    }
}

Кінцевий до кінця приклад з логінг і базові перевірки

Цей приклад створює 7Z архіву з змішаного списку джерел. Він підтверджує шляхи і записи результатів.

// File: BuildArchive.cs
using System;
using System.Collections.Generic;
using System.IO;
using Aspose.Zip.SevenZip;

public static class BuildArchive
{
    public static bool Run(IEnumerable<string> paths, string output7z)
    {
        if (paths == null) throw new ArgumentNullException(nameof(paths));
        Directory.CreateDirectory(Path.GetDirectoryName(Path.GetFullPath(output7z)) ?? ".");

        int added = 0, skipped = 0;

        using var archive = new SevenZipArchive();

        foreach (var p in paths)
        {
            if (string.IsNullOrWhiteSpace(p)) { skipped++; continue; }

            if (File.Exists(p))
            {
                using var fs = File.OpenRead(p);
                var entryName = Path.GetFileName(p);
                archive.CreateEntry(entryName, fs);
                Console.WriteLine("Added file: " + entryName);
                added++;
            }
            else if (Directory.Exists(p))
            {
                var basePath = Path.GetFullPath(p);
                foreach (var fp in Directory.GetFiles(basePath, "*", SearchOption.AllDirectories))
                {
                    var rel = Path.GetRelativePath(basePath, fp).Replace(Path.DirectorySeparatorChar, '/');
                    using var fs = File.OpenRead(fp);
                    archive.CreateEntry(rel, fs);
                    Console.WriteLine("Added: " + rel);
                    added++;
                }
            }
            else
            {
                Console.WriteLine("Skip missing: " + p);
                skipped++;
            }
        }

        using var outStream = File.Create(output7z);
        archive.Save(outStream);

        Console.WriteLine($"Saved: {Path.GetFullPath(output7z)}");
        Console.WriteLine($"Entries added: {added}, skipped: {skipped}");
        return added > 0;
    }
}

// Usage sample:
// BuildArchive.Run(new [] { "README.md", "assets", "docs/spec.pdf" }, "release.7z");

Найкращі практики

  • Використання попередніх слайдів для вхідних іменБагато інструментів показують шляхи більш послідовно, коли входи використовуються / Як і сепаратор.

    • Доступні потоки *Завжди втілюйте файли потоків в using Блоки. вищезазначені зразки забезпечують чисте розташування.
    • Валютні входи*Перевірте, які файли існують, перш ніж додати їх.

  • ** Зберігайте архіву чистою*Виберіть корінне ім’я папки всередині архіву і прикріптеся до нього, наприклад, app/ або package/.

    • Тест на цільових платформах*Переконайтеся, що ваш 7z відкривається правильно в інструментах, на які залежить ваш користувач.

резюме

Ви програматично створили 7z-архіву з Aspose.ZIP для .NET, додали файли з диска і пам’яті, зберегли чисту структуру папки, і врятували результат до .7zВикористовуйте ці шаблони для упаковки випусків, пакетів та експорту безпосередньо з ваших додатків C#.

More in this category