ZipFileExtensions.CreateEntryFromFile Метод

Определение

Пространство имен:

System.IO.Compression

Сборка:

System.IO.Compression.ZipFile.dll

Архивирует файл, сжимая его и добавляя его в ZIP-архив.

Перегрузки

CreateEntryFromFile(ZipArchive, String, String)	Архивирует файл, сжимая его и добавляя его в ZIP-архив.
CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)	Архивирует файл, сжимая его с использованием заданного уровня сжатия и добавляя его в ZIP-архив.

CreateEntryFromFile(ZipArchive, String, String)

Исходный код:

ZipFileExtensions.ZipArchive.Create.cs

Архивирует файл, сжимая его и добавляя его в ZIP-архив.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Compression::ZipArchiveEntry ^ CreateEntryFromFile(System::IO::Compression::ZipArchive ^ destination, System::String ^ sourceFileName, System::String ^ entryName);

public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName);

static member CreateEntryFromFile : System.IO.Compression.ZipArchive * string * string -> System.IO.Compression.ZipArchiveEntry

<Extension()>
Public Function CreateEntryFromFile (destination As ZipArchive, sourceFileName As String, entryName As String) As ZipArchiveEntry

Параметры

destination

ZipArchive

ZIP-архив, в который добавляется файл.

sourceFileName

String

Путь к файлу, который необходимо заархивировать. Можно указать относительный или абсолютный путь. Относительный путь интерпретируется относительно текущего рабочего каталога.

entryName

String

Имя записи, которую требуется создать в ZIP-архиве.

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

ZipArchiveEntry

Программа-оболочка для новой записи в ZIP-архиве.

Исключения

ArgumentException

sourceFileName имеет значение Empty, содержит только пробел или по крайней мере один недопустимый символ.

-или-

entryName имеет значение Empty.

ArgumentNullException

Параметр sourceFileName или entryName имеет значение null.

PathTooLongException

В sourceFileName длина указанного пути, имени файла или обоих параметров превышает установленное в системе максимальное значение.

DirectoryNotFoundException

Недопустимый sourceFileName (например, он ведет на несопоставленный диск).

IOException

Файл, указанный параметром sourceFileName , не может быть открыт или слишком велик для обновления (текущее ограничение — Int32.MaxValue).

UnauthorizedAccessException

Параметр sourceFileName задает каталог.

-или-

У вызывающего объекта отсутствует разрешение на доступ к файлу, указанному параметром sourceFileName.

FileNotFoundException

Файл, заданный параметром sourceFileName, не найден.

NotSupportedException

Параметр sourceFileName имеет недопустимый формат.

-или-

ZIP-архив не поддерживает запись.

ObjectDisposedException

ZIP-архив был удален.

Примеры

В следующем примере показано, как создать новую запись в ZIP-архиве из существующего файла.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt");
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

Комментарии

Новая запись в архиве содержит содержимое файла, указанного параметром sourceFileName. Если запись с указанным именем (entryName) уже существует в архиве, создается вторая запись с идентичным именем. Свойству LastWriteTime записи присваивается время последнего изменения файла в файловой системе.

При ZipArchiveMode.Update наличии предельный размер записи ограничен Int32.MaxValue. Это ограничение связано с тем, что в режиме обновления используется MemoryStream внутренне для разрешения поиска, необходимого при обновлении архива, и MemoryStream имеет максимальный размер, равный размеру int.

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Исходный код:

ZipFileExtensions.ZipArchive.Create.cs

Архивирует файл, сжимая его с использованием заданного уровня сжатия и добавляя его в ZIP-архив.

public:
[System::Runtime::CompilerServices::Extension]
 static System::IO::Compression::ZipArchiveEntry ^ CreateEntryFromFile(System::IO::Compression::ZipArchive ^ destination, System::String ^ sourceFileName, System::String ^ entryName, System::IO::Compression::CompressionLevel compressionLevel);

public static System.IO.Compression.ZipArchiveEntry CreateEntryFromFile (this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel);

static member CreateEntryFromFile : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel -> System.IO.Compression.ZipArchiveEntry

<Extension()>
Public Function CreateEntryFromFile (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel) As ZipArchiveEntry

Параметры

destination

ZipArchive

ZIP-архив, в который добавляется файл.

sourceFileName

String

Путь к файлу, который необходимо заархивировать. Можно указать относительный или абсолютный путь. Относительный путь интерпретируется относительно текущего рабочего каталога.

entryName

String

Имя записи, которую требуется создать в ZIP-архиве.

compressionLevel

CompressionLevel

Одно из значений перечисления, указывающее, акцентировать ли внимание на скорости или эффективности сжатия при создании записи.

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

ZipArchiveEntry

Программа-оболочка для новой записи в ZIP-архиве.

Исключения

ArgumentException

sourceFileName имеет значение Empty, содержит только пробел или по крайней мере один недопустимый символ.

-или-

entryName имеет значение Empty.

ArgumentNullException

Параметр sourceFileName или entryName имеет значение null.

DirectoryNotFoundException

Недопустимый sourceFileName (например, он ведет на несопоставленный диск).

PathTooLongException

В sourceFileName длина указанного пути, имени файла или обоих параметров превышает установленное в системе максимальное значение.

IOException

Файл, указанный параметром sourceFileName , не может быть открыт или слишком велик для обновления (текущее ограничение — Int32.MaxValue).

UnauthorizedAccessException

Параметр sourceFileName задает каталог.

-или-

У вызывающего объекта отсутствует разрешение на доступ к файлу, указанному параметром sourceFileName.

FileNotFoundException

Файл, заданный параметром sourceFileName, не найден.

NotSupportedException

Параметр sourceFileName имеет недопустимый формат.

-или-

ZIP-архив не поддерживает запись.

ObjectDisposedException

ZIP-архив был удален.

Примеры

В следующем примере показано, как создать новую запись в ZIP-архиве из существующего файла и указать уровень сжатия.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest);
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

Комментарии

Новая запись в архиве содержит содержимое файла, указанного параметром sourceFileName. Если запись с указанным именем (entryName) уже существует в архиве, создается вторая запись с идентичным именем. Свойству LastWriteTime записи присваивается время последнего изменения файла в файловой системе.

При ZipArchiveMode.Update наличии предельный размер записи ограничен Int32.MaxValue. Это ограничение связано с тем, что в режиме обновления используется MemoryStream внутренне для разрешения поиска, необходимого при обновлении архива, и MemoryStream имеет максимальный размер, равный размеру int.