ZipFileExtensions.CreateEntryFromFile Метод

Определение

Пространство имен:: System.IO.Compression

Сборка:: System.IO.Compression.ZipFile.dll

Сборки:: netstandard.dll, System.IO.Compression.ZipFile.dll

Сборка:: System.IO.Compression.FileSystem.dll

Сборка:: netstandard.dll

Важно!

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

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

Перегрузки

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

CreateEntryFromFile(ZipArchive, String, String)

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: 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 is 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

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: ZipFileExtensions.ZipArchive.Create.cs

Исходный код:: 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 is 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

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

ZipFileExtensions.CreateEntryFromFile Метод

Определение

Перегрузки

CreateEntryFromFile(ZipArchive, String, String)

Параметры

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

Исключения

Примеры

Комментарии

Применяется к

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Параметры

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

Исключения

Примеры

Комментарии

Применяется к