Объектная модель > Основные механизмы > Zip – zip-архив > Add

Метод используется для добавления в zip-архив данных. С помощью перегрузок метода в zip-архив можно добавить бинарные данные (IBinaryData), поток данных (Stream), массив байтов (byte[]), вложенный архив (IZip), подпись (ISignature) или отчет (IReport).

Метод доступен только в серверном коде.

Перегрузки

Add(IBinaryData data, string fileName, params string[] path)	Добавить в zip-архив бинарные данные
Add(Stream data, string fileName, string extension, params string[] path)	Добавить в zip-архив поток данных
Add(IZip innerZip, string fileName, params string[] path)	Добавить в zip-архив другой архив ВАЖНО. Допускается только один уровень вложенности, то есть вкладываемый архив не должен содержать другие архивы. Также нельзя добавлять данные во вложенные архивы после вызова метода Save()
Add(ISignature signature, string fileName, params string[] path)	Добавить подпись в zip-архив
Add(byte[] data, string fileName, string extension, params string[] path)	Добавить в zip-архив массив байтов
Add(IReport report, string fileName, params string[] path)	Добавить в zip-архив отчет

Синтаксис

public static string Add(IBinaryData data, string fileName, params string[] path)

public static string Add(Stream data, string fileName, string extension, params string[] path)

public static string Add(IZip innerZip string, fileName, params string[] path)

public static string Add(ISignature signature, string fileName, params string[] path)

public static string Add(byte[] data, string fileName, string extension, params string[] path)

public static string Add(IReport report, string fileName, params string[] path)

Параметры

data – бинарные данные; поток данных; массив байтов; Значение параметра меняется в зависимости от перегрузки;

innerZip – вложенный архив;

signature – подпись;

report – отчет.

filename – имя файла в архиве;

extension – расширение файла в архиве. Параметр используется, только если в архив добавляется массив байтов;

path – относительный путь в архиве.

Возвращаемое значение

Относительный путь до файла в архиве.

Пример 1. Добавление в ZIP-архив бинарных данных

// Добавить в zip-архив содержимое документов.
var body = zipModel.IsPublicBody ? version.PublicBody : version.Body;
zip.Add(body, zipModel.FileName, zipModel.FolderRelativePath.ToArray());

Пример 2. Добавление в ZIP-архив вложенных архивов

var zip = Sungero.Core.Zip.Create();
 
var nestedZip1 = Sungero.Core.Zip.Create();
nestedZip1.Add(version1.Body, "Документ 1.txt");
 
var nestedZip2 = Sungero.Core.Zip.Create();
nestedZip2.Add(version2.Body, "Документ 2.txt");
 
zip.Add(nestedZip1, "Вложенный архив 1");
zip.Add(nestedZip2, "Вложенный архив 2");
 
zip.Save("Имя архива");

Add – добавить в zip-архив данные

Add – добавить в zip-архив данные